mender-server

Mender Server monorepo

Getting started

Before you start the Mender server, make sure you have Docker Compose installed. Mender server requires Docker Compose version v2.23.1 or newer.

docker compose version

You will also need to update your local DNS or host rewrites, for example by appending to /etc/hosts:

echo '127.0.0.1   docker.mender.io s3.docker.mender.io' | sudo tee -a /etc/hosts

Note

This docker composition is only meant for evaluation purposes. Please use the helm chart in production environments.

Start by cloning and entering this repository:

git clone https://github.com/mendersoftware/mender-server && cd mender-server

To start evaluating Mender, you can bring up your Mender server by running:

docker compose up -d

Once all containers are running, you can create your initial user using the following command:

[email protected]
MENDER_PASSWORD=password123
docker compose exec useradm useradm create-user --username "$MENDER_USERNAME" --password "$MENDER_PASSWORD"

Visit https://localhost and sign in using the credentials from the snippet above.

Adding a virtual client

To add a virtual client with the composition, run the following command:

docker compose run -d client

Evaluating Mender enterprise

Warning

We strongly advise using the helm chart for production setups. This docker composition is only meant for evaluation purposes.

For paying customers with access to private enterprise components, you can evaluate the Mender Server enterprise by replacing the above snippets from the following section. To start the server run:

export COMPOSE_FILE="docker-compose.yml:compose/docker-compose.enterprise.yml"
docker compose up -d

Important

This composition will not work without a paid license with access to registry.mender.io.

To initialize the admin user, use the following snippet:

MENDER_NAME=Admin
[email protected]
MENDER_PASSWORD=password123
docker compose exec tenantadm tenantadm create-org --username "$MENDER_USERNAME" --password "$MENDER_PASSWORD" --name "$MENDER_NAME"

Visit https://localhost and sign in using the credentials from the snippet above.

Testing Gitlab build artifacts

To test/debug artifacts from GitLab CI, you can pull the image straight from the internal registry (after generating credentials). For testing, you need to setup the following environment variables:

CI_PIPELINE_IID="1234" # The number of the pipeline
export MENDER_IMAGE_REGISTRY=registry.gitlab.com
export MENDER_IMAGE_REPOSITORY=northern.tech/mender/mender-server
export MENDER_IMAGE_TAG=build-$CI_PIPELINE_IID
export MENDER_IMAGE_TAG_TEST=test-$CI_PIPELINE_IID