You are browsing documentation for a version other than the latest stable release. Switch to the latest stable release, 1.2.
Following this tutorial will create a demo installation of the Mender, appropriate for testing and experimenting. When you are ready to install for production, please follow the Production installation documentation.
Make sure you satisfy the server requirements before proceeding.
In a working directory, download the Mender integration environment:
curl -L https://github.com/mendersoftware/integration/archive/1.1.3.tar.gz | tar xz
Mender currently requires two entries in your
/etc/hosts file to work with the Docker networking (typically
127.0.0.1 s3.docker.mender.io and
127.0.0.1 docker.mender.io). If these entries do not exist as you run the
up script (below), it will create them for you and thus might ask for your administrative password. If you want to avoid automatic creation, you can create the entries in advance; look inside the script for the details how it is created on your host.
Mender comes with a wrapper script that brings up the environment with Docker Compose. Running this script will pull down the images and start them:
If this is the first time you start the Mender server, several gigabytes of Docker images may need to be downloaded. On a 100Mbit Internet connection this may take 5 minutes.
After the Docker images have been downloaded, the Mender services start up and you will see a lot of log messages from them in your terminal.
This includes output from the Mender virtual device.
A few minutes later, the logs will stop coming except for some periodic log messages
from the Mender
For security reasons, the Mender gateway only allows secure connections using TLS, both for communicating with devices and end users. Your web browser will communicate directly with the gateway while using the Mender UI and therefore the certificate the gateway is using needs to be trusted by your web browser.
The Mender UI can now be found on https://localhost/ - simply open it in your web browser and accept the certificate. In Chrome it should look like the following:
The first time you access the UI, you will be asked to create the initial user. Simply input your email and desired password as shown below:
Your email and password are currently only used to log in to the Mender server. You will not receive any email from Mender. However, this might change in future versions so we recommend to input your real email address. Mender currently supports one user account, support for multiple user accounts will be implemented shortly. If you lose your username or password, please see the documentation on resetting administrative credentials.
Congratulations! You have the Mender server and a virtual Mender client successfully running! Please proceed to Deploy to virtual devices.