Icon with a starting rocket

Installing a Cloudogu EcoSystem

Hello and thank you for your interest in our Cloudogu EcoSystem. If you have any suggestions or questions, please contact us via e-mail at hello@cloudogu.com or by phone at +49. 531. 61 80 88 80.

Where can you get your image?

The easiest way to set up a Cloudogu EcoSystem is to download an image via the myCloudogu platform.

You only need a free account on the platform, which can then also be used to register the instance during the installation.

Download options


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.

Setup steps

After you successfully imported the virtual machine, you should check that machine’s network adapter is set to bridged or Network bridge. After that you can start the machine in your virtualization environment and begin with the setup.

Start Setup Wizard

The setup for the machine is now available under 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.

IP Adresse

After the login you will see the IP address of the machine and you can start the setup wizard under http://ip-address:8080.

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.

Finish the registration

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.

Region settings

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.

User Backend

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.

Dogu selection

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.

Configuration of administrator

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.

Setup process

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.

Access data

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.

CES WarpMenu