Setting up the Greenbone Community Edition (GCE) Virtual Machine

Prerequisites and Introduction

The Greenbone Community Edition is a derivative of the GSM ONE and serves as a quick and easy trial option for the Greenbone Security Manager on Microsoft Windows, Linux and macOS. The GCE as well as the GSM ONE are designed for using them with a laptop.

The GCE uses the Greenbone Community Feed instead of the more extensive Greenbone Security Feed. Feed updates are available on a regular basis, but the GCE itself cannot be updated. The commercial Greenbone Security Manager solutions can be updated seamlessly and include access to the Greenbone Security Feed.

Several advanced features, e.g., TLS certificate management, schedules, alerts, integrated backups, master-sensor functionality, VLANs, network namespaces and air-gap support, are not included in the GCE. All features mentioned are available in the Greenbone Security Manager solutions which can be requested from Greenbone Networks as evaluation units.

Access to Greenbone Networks Support is only available for Greenbone Security Manager solutions but not for the GCE.

Starting up the Greenbone Community Edition

Note: The process is described using Oracle VirtualBox.

  1. Open VirtualBox or VMware Player/Workstation.

  2. Click “New”.

  3. Enter the name of the virtual machine in the input box “Name”.

  4. Select “Linux” in the drop-down list “Type” and “Other Linux (64-bit)” in the drop-down list “Version” and click “Next >”.
    Screenshot from 2019-12-31 13-58-13

  5. Set the memory to 4096 MB and click “Next >”.
    Screenshot from 2019-12-31 13-59-54

  6. Select the radio button “Create a virtual hard disk now” and click “Create”.
    Screenshot from 2019-12-31 14-02-23

  7. Select the radio button “VMDK (Virtual Machine Disk)” and click “Next >”.
    Screenshot from 2019-12-31 14-05-01

  8. Select the radio button “Dynamically allocated” and click “Next >”.
    Screenshot from 2019-12-31 14-08-15

  9. Set the size to 18 GB and click “Create”.
    Screenshot from 2019-12-31 14-08-31

  10. Right click the newly created virtual machine and select “Settings”.

  11. Select “System > Motherboard” and deactivate the checkbox “Floppy”.

  12. Select “PS/2 Mouse” in the drop-down list “Pointing Device”.

  13. Select “System > Processor” and set the number of processors to 2.

  14. Select “Audio” and deactivate the checkbox “Enable Audio”.

  15. Select “USB” and deactivate the checkbox “Enable USB Controller”.

  16. Select “Network > Adapter 1” and select “Bridged Adapter” in the drop-down list “Attached to”.

  17. Select “Storage”.

  18. Select the previously created VMDK and activate the checkbox “Solid-state Drive”.

  19. Select “Empty”, click Screenshot from 2019-12-31 14-38-43 and select “Choose Virtual Optical Disk File”.

  20. Select the downloaded .iso-file of the GCE.

  21. Click “OK”.

  22. Start the created virtual machine.

  23. Select “Setup” and press Enter .

  24. Confirm the displayed message by pressing Enter .

    → The installation process is started.

  25. Enter a user name and press Enter .

  26. Enter a password and press Enter .

  27. Confirm the displayed message by pressing Enter.

    → The GSM reboots twice. Do not try to log in after the first reboot!

  28. As soon as the login message “Welcome to Greenbone OS” is shown, log in using the previously created user name and password.

  29. Perform the general system setup as described here.

Additional Notes

  • During the installation, a self-signed TLS certificate is created. When logging in to the web interface, the web browser will regard it as insecure. Tell the web browser to accept it as an exception.
  • Before the feed update is completed, not all SecInfo is available and scans are not possible.
  • Shutting down or rebooting the virtual machine should only be done by selecting “Maintenance > Power” in the GOS administration menu to ensure that important system processes, e.g., the feed update, are not interrupted.

Copyright, Licenses and Sources

The Feed and Greenbone OS consists of various components with various Copyrights and (Open Source) Licenses. In essence the product can be used for any purpose but for re-distribution the conditions of the licenses have to be considered. Details are summarized in the License Information. There, you will also find the offer for source code access according to GNU GPL.