Mender is an open source over-the-air (OTA) software updater for embedded Linux devices. Mender comprises a client running at the embedded device, as well as a server that manages deployments across many devices.
This repository contains a Docker-based environment allowing to run all Mender
backend services as a single system. Each service has a dedicated Dockerhub
repository, where tagged Docker builds are stored. Images are pulled and started
in a coordinated fashion via docker-compose and the associated
docker-compose.yml file.
Requirements:
- docker-engine 1.10
- docker-compose 1.7
To start using Mender, we recommend that you begin with the Getting started section in the Mender documentation.
Start the Mender demo server with the following command:
./demo up
Access the Mender server on https://localhost using the user and password created by the script.
Save the credentials for later re-use.
For consequent runs of the script to create a new password, delete first all volumes with:
./demo down -v
The setup comes with a predefined client service (mender-client) that runs a
qemu VM in a container. The client will connect to the backend by accessing
docker.mender.io host (an alias assigned to the API gateway service). The
client container will not run by default. You can manually launch it with:
docker-compose --client up
We welcome and ask for your contribution. If you would like to contribute to Mender, please read our guide on how to best get started contributing code or documentation.
Mender is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.
We take security very seriously. If you come across any issue regarding security, please disclose the information by sending an email to security@mender.io. Please do not create a new public issue. We thank you in advance for your cooperation.
- Join the Mender Hub discussion forum
- Follow us on Twitter. Please feel free to tweet us questions.
- Fork us on Github
- Create an issue in the bugtracker
- Email us at contact@mender.io
- Connect to the #mender IRC channel on Libera
Mender was created by the team at Northern.tech AS, with many contributions from the community. Thanks everyone!
Mender is sponsored by Northern.tech AS.