Verify the installation

Run the following command to verify the correct startup and initialization of Akamas:

akamas status

When all services have been started, this command will return an "OK" message. Please note that it might take a few minutes for Akamas to start all services.

To check the UI is also properly working please access the following URL:

http://<akamas server name here>

You will see the Akamas login form:

Please notice that it is impossible to log into Akamas before a license has been installed. Read here how to Install an Akamas license.

Sample Study Creation During Installation

After running the basic checks (like akamas status) to confirm that all Akamas services are running, you may notice that a sample study is automatically created by default. This study can then be run to ensure that your Akamas environment is correctly installed and operational.

Disabling the Automatic Sample Study

If you do not want this study to be created automatically, you can disable it as follows:

Docker

Within your docker-compose.yml, in the akamas-init service (the “Akamas Initializer”), locate the environment variable CREATE_SAMPLE_STUDY and set it to false. For example:

akamas-init:
    environment:
      - CREATE_SAMPLE_STUDY=false

This ensures that the initializer won’t create the study during startup.

Kubernetes

In your Akamas chart folder, edit the values file (for example, values-files/my-values.yaml) to include:

createSampleStudy: false

This prevents the study creation in the Kubernetes deployment.

By disabling the sample study feature, Akamas will be installed without automatically creating and running that study. You can then follow the Optimization Guides to create your own studies.

Note: The creation of the Sample Study can add up to 10 extra minutes to Akamas' startup time.