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 running the image on a server, you can use these virtualization tools.
After you successfully imported and started the image in your virtualization environment you can start the setup.
Start Setup Wizard
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 login you will see the IP address of the machine and you can start the setup wizard under
Registration (CES Instance Registration)
Now you can start the setup using “Register instance”. The registration grants you access to the Dogus that are provided.
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). If you have any questions, please contact us.
If desired, you can get customized support and custom development packages, e.g. for the implementation of additional Dogus.
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.