Installing a Cloudogu EcoSystem via VirtualBox

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 I get your image?

The easiest way to set up a Cloudogu EcoSystem is to download the VirtualBox 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 CES

If you want to verify the download, this is the SHA256-hash of the image.


Preparations

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.

Virtual Box configuration

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.

Import of the machine

After you have specified the downloaded image and made any necessary adjustments, you can start the import.

Import of the machine

You can start the machine after the import is successfully completed.

Status of the machine

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.


Setup steps

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, please check the IP address with ip a. You can log in to the machine with username ces-admin and password ces-admin.
Important: The password will be changed to a random string at the end of the setup process, which you will be informed about.

Registration

You can start the process using “Register instance” in the setup.

Login

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.

Finish the registration

Then confirm the registration of your instance under your account.

Successful 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.

Naming

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).

Dogu selection

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.

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.

Setup

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