Installing the SDK for local development

Table of contents

  • Introduction
  • Prerequisites
    • Linux and Mac
    • Windows
  • Access to the Alumio code
    • Composer repository
    • Requesting access
  • Setting up a new project
    • Accessing the project
  • Stopping and restarting the environment
  • How to keep your local Alumio installation up to date


Installing Alumio for development can be done with a few simple steps described below. The process has been set up so that engineers can get started with Alumio without having to worry about their local development set up.

You will need to become an Alumio solution partner in order to get access to the Software Development Kit (SDK). Reach out to your sales representative to receive more information.


Requirements to run Alumio locally:

Although our software can run on the operating systems listed below, we recommend running Alumio on Linux. On Linux, Alumio performs at its best.
Currently the SDK supports both PHP 7 and PHP 8.

When starting a new project we highly recommend using PHP 8 as it will be supported further in the future.

Linux and Mac

Install the necessary tools:


It is recommended to increase the default amount of memory available to Docker to at least 6 GB.

  • Open **Docker** by pressing the Command key and typing **Docker**.
  • In the settings click on the **Advanced** tab.
  • Increase the amount of memory and click **Apply & Restart**.


Currently not supported.

Access to the Alumio code

Composer repository

The Alumio code depends on other packages which are hosted on a composer repository. To be able to install Alumio dependencies access to this repository is needed. These credentials will be provided on request, by Alumio.

Requesting access

To get access to the Alumio code send an email to your Alumio contact person and ask for Composer access. Login details will be provided to access the composer repository.

Setting up a new project

To set up a new project run the following command:

bash -c "$(curl -sL" -s alumio-sdk

This will create a project in the Alumio-sdk directory and install all dependencies that Alumio needs.

The project is now set up and ready for development.

Accessing the project

After setting up the project by default the following services are available:

Credentials for the different services are available in **** and can be overwritten with ****.

To access the project, go to the dashboard and enter the port of API (default: 3200) as the environment.

Stopping and restarting the environment

Use the Alumio command to stop all docker instances:

cd alumio-sdk 
alumio down

The environment can be started again by doing:

cd alumio-sdk 
alumio up

How to keep your local Alumio installation up to date

Use the composer command to update dependencies:

cd alumio-sdk 
alumio console 
composer update

Use the Alumio command to update docker files

cd alumio-sdk 
alumio selfupdate 
alumio update