Installing a Cloudogu EcoSystem via VirtualBox
In order to get started with the Cloudogu EcoSystem, you first need a virtualization environment to operate the platform. Ideally, you will own a powerful local machine or have hardware that you can utilize in a data center.
Your hosting provider may have instructions on how to load and use third-party images on your system.
If you are not intending to operate the image in a server environment, we recommend using the current version of VirtualBox.
Setup in VirtualBox
You can start the setup process after downloading the image.
A context menu is displayed via the “Import” tab on the start page of the program. You must select “Expert mode” in order to use the “Assign new MAC addresses for all network cards” option.
After you have specified the downloaded image and made any necessary adjustments, you can start the import.
You can start the machine after the import is successfully completed. Important: Make sure that the network device of the machine is set to
Configuring the image for operation on a hosting provider
For directions about how to import the image to your hosting provider, please consult the hosting provider FAQ. The file format may differ. If you need to convert the image, we cannot guarantee that the image will work correctly after such a conversion. Please contact us if you need another format.
Registration (CES Instance Registration)
You must register the instance in order to get access to the Dogus that we provide. Your first instance is completely free. If you have any questions, please contact us. If you have needs that we have not addressed in these directions, we can provide you with custom support on an individual contract basis. This also includes the implementation of additional Dogus that can address your personal needs.
The setup for the machine is now available under
http://192.168.0.56:8080. If this is not the case, your network assigned a different IP to the machine. To find out the IP address, you have to log into the machine using the CLI. The login credentials for the machine are username
ces-admin and password
ces-admin. Hint: The keyboard layout of the machine is English, so you might have trouble with the “-“. Important: The password of the ces-admin user will be changed to a random string at the end of the setup process, which you will be informed about.
After the successful login you will see the IP address of the machine. You can start the setup under
You can start the process using “Register instance” in the setup.
You can use your myCloudogu account to register your instance. Alternatively, you can also log in with a GitHub or Google account or register a new account.
Then confirm the registration of your instance under your account.
Region (Set region specific settings)
After you complete the registration process, you will start to configure your instance. The first step is to determine the region of your instance.
Naming (FQDN, Hostname, Domain and Certificates)
In the next step, we will need information about the accessibility of your instance and e-mail sending settings.
Note on FQDN: The “FQDN” shows the IP address of the virtual system by default. You can also change the “FQDN,” such as, for example, by entering a company-specific URL. A combination of “host name” and “domain” is recommended. If no FQDN is specified, the CES can only be reached via IP address.
Note on Certificate Type: If you don’t have any certificates for your instance yet, you can select “Self Signed”. However, we recommend that you use third party certificates for a live production-ready system.
Note on Mail Relay Host: The Cloudogu EcoSystem can only send e-mails if a valid mail server is specified. The mail relay host can be specified both as a URL and as an IP address. However, if you enter an incorrect mail relay host, such as for test purposes, for example, then this is not a problem.
User Backend (Configure your directory service)
Please select the desired user administration database. We can deliver an implemented version directly to you. If you already have your own LDAP or Active Directory, you can of course connect and configure it.
Dogu (Choose your Dogus)
Pick your tools (Dogus) and set a Dogu as the start page after login (Default Dogu).
You can find details on the Dogus in our glossary.
Note: Dependencies between Dogus are automatically taken into account. If you select “Jenkins CI”, for example, then “Central Authentication Service”, “Nginx”, “Postfix” and “Registrar” are also automatically selected, since these are required for the operation of Jenkins.
In the Default Dogu field you can choose which Dogu should be displayed when you first log in to your Cloudogu EcoSystem. This setting applies to all users of the platform.
Note: Users of the Community Edition of the Cloudogu EcoSystem have access to fewer Dogus. Premium Dogus, such as “Backup & Restore,” cannot be used with this edition.
Admin (Configure the Administrator)
In the last configuration step, you will create the first user for your Cloudogu EcoSystem and a group name for administrators.
Note: The administrator group (Admin Group) is a preset group of the embedded Directory Service, which gives members administrative access to the installed tools.
In order to authorize your user as an administrator in the Dogus, select the “Configure the user also as tool administrator” checkbox.
Note: Even if you do not give the first user administrator privileges, this user still has privileges to create additional users in the embedded directory service and to assign administrator privileges.
If you have specified a valid mail relay host, you can optionally choose to have the automatically generated UNIX access data sent to the stored e-mail address. Irrespective of this, they are displayed once after the installation has been completed.
During the last phase you can see how the installation is carried out step by step with the configuration you have created.
Once the setup process has been completed, your UNIX access data will be displayed once. Be careful to save this data to a safe place.
You can also navigate directly to the Cloudogu EcoSystem using the provided link. Depending on the performance specifications of the machine on which you have just installed the Cloudogu EcoSystem, it may take a few minutes until all of the Dogus have launched and you can log in.
This completes the installation of your Cloudogu EcoSystem. You can now start adding users and data to the system.
A brief introduction to the Cloudogu EcoSystem
Depending on which Dogus you have selected, you will now have an extensive selection of different tools that you can choose from. Important: Note the arrow on the right middle edge of the screen. You can use this arrow to summon the side navigation bar, which will take you to the installed Dogus.