Greenbone Free at a Glance

Requirements

• Compatibility: Oracle VirtualBox 6.1 or higher
• Minimum requirements: 2 CPUs, 5 GB RAM
• Virtual network adapter with direct Internet connection
  Note: With default settings, Greenbone Free uses bridged networking and expects an IP address from a DHCP server. This may be reconfigured.

Importing Greenbone Free

1. Download OVA file Greenbone Free.
2. Download and install Oracle VirtualBox for the operating system used.
3. Start VirtualBox.
4. Select File > Import Appliance… in the menu bar.
5. Click and select the OVA file of the appliance in the file system.
   
6. Click Next.
   → The appliance settings are displayed.
   
7. Check the configuration of the virtual machine.
   Values can be changed by double-clicking in the input field of the corresponding value.
8. Click Import.
   → The appliance is being imported. This process can take up to 10 minutes.
   When the appliance has been imported, it will appear in the left column in VirtualBox.
9. Select the appliance in the list and click Start.
   → If an error message is displayed, continue with step 10.
   If no error message is displayed, the GOS administration menu is opened and allows to proceed with the general system setup.
10. Select the appliance in the list and click Settings.
11. Select Network > Adapter 1.
12. Choose the correct network adapter in the drop-down list Name.
13. Click OK.
14. Select the appliance in the list and click Start.
    → The GOS administration menu is opened and allows to proceed with the general system setup.

Performing a General System Setup

1. Log in using the following login information:
   User name: admin | Password: admin

   → When logging in for the first time, the GOS administration menu displays the First Setup Wizard to help with the basic configuration of GOS.
   

2. Select Yes and press und Enter to open the Wizard.
   Note: The wizard can be closed by selecting No and pressing Enter. Steps that have not yet been completed will be displayed again at the next login.
   The wizard can also be closed by selecting Cancel and pressing Enter. In this case, however, incomplete steps will not be displayed again.
   Any step can be skipped by selecting Skip or No and pressing Enter. Skipped steps will be displayed again at the next login.

   → It is asked whether a web user should be created. This is required to use the web interface.

   Note: The first web administrator (web user) created is automatically the Feed Import Owner (more information about the Feed Import Owner here).
3. Select Yes and press Enter.
4. Enter the user name of the web administrator.
5. Enter the password of the web administrator twice.
6. Select OK and press Enter.
   → A message informs the user that the web administrator has been created.
7. Press Enter to close the message.
   Note: If no valid feed subscription key is stored on the appliance, the appliance only uses the public Greenbone Community Feed and not the Greenbone Enterprise Feed.

   
   The key can be entered or uploaded as follows:

8. Select Editor and press Enter.
   → The editor is opened.
9. Enter the subscription key.
10. Press Strg + X.
11. Press Y to save the changes.
12. Press Enter.

or

8. Select HTTP Upload and press Enter.
9. Open the web browser and enter the displayed URL.
10. Click Browse….
11. Select the subscription key in the file system.
12. Click Upload.
    → A message shows that the key has been imported successfully.
13. Press Enter.

After the last step, a status check is performed. A message shows the result.

Accessing the Web Interface

The web interface can be accessed as follows:

1. Open the web browser.
2. Enter the IP address of the appliance’s web interface.

   Note: The IP address of the appliance’ s web interface can be displayed as follows:

   • During the login to the GOS administration menu
   • By selecting About and pressing Enter in the GOS administration menu
3. Log in with the web administrator created during setup.
   → The web interface is opened.

Additional Notes

• It is recommended to change the password of the GOS administrator as described in the manual.
• Greenbone Free uses a self-signed TLS certificate. When logging in to the web interface, this is considered insecure by the web browser and must therefore be added to the web browser as an exception.
• Shutting down or restarting the virtual machine should only be done via the menu option Maintenance > Power in the GOS administration menu to ensure that important system processes, such as the feed update, are not interrupted.