Configure MAPIO OS

Basics configuration

Some basic setup can be done from the webapp configuration.

Check that the setup wizard web server is running using the epaper interface. The web server is automatically running at first boot and until it has been disabled.

With a navigator, go the address http://YOUR_LOCAL_IP:8456/

You will see the following homepage:


In SSH setup page you can add you ssh key, to access the MAPIO board with a console.

Advanced configurations

When you have added you own SSH key using the webapp you can access to console with SSH

$ ssh root@YOUR_LOCAL_IP

In /home/root directory with you find some directories for each Docker compose file example. You can modify these docker compose files for your need.


/home/root is erased when you update the OS with a new bundle. If you want to keep your files use the persistent partition mounted on /usr/local/

Configure your reverse proxy with Caddy

Caddy is a easy to set up reverse proxy : In this example we will explain how to set up your own reverse proxy on Mapio. The the reverse proxy allows to run several services on the Mapio behind a server that manages the redirections and HTTPS certificates.

From the file /home/root/caddy/docker-compose.yml we see that the Caddyfile configuration is located here /usr/local/caddy/Caddyfile We consider that you have already do the following setup:

  • Have a public domain name or address (YOUR_PUBLIC_DOMAIN)

  • Have setup your internet box to redirect the 443 to your MAPIO

The following exposes your local Home Assistant instance throw the Caddy reverse proxy. Edit /usr/local/caddy/Caddyfile with theses content

    reverse_proxy host.docker.internal:8123

If Caddy was not already start it:

$ docker-compose -f /home/root/caddy/docker-compose.yml up -d

If Caddy was already running restart it :

$ docker-compose -f /home/root/caddy/docker-compose.yml restart

You can now access to your Home Assistant with a web browser https://YOUR_PUBLIC_DOMAIN

You can add other services (if the service can run on a subdomain). Now Home Assistant can not be configured on a subdomain.

For example the following Caddyfile exposes both an Home Assistant (port 8123) and a Nextcloud (8092)

    reverse_proxy host.docker.internal:8123

    redir /.well-known/carddav /remote.php/dav 301
    redir /.well-known/caldav /remote.php/dav 301
    header Strict-Transport-Security max-age=31536000;
    reverse_proxy host.docker.internal:8092

You can access to:

  • Home Assistant : https://YOUR_PUBLIC_DOMAIN

  • Nextcloud : https://ncloud.YOUR_PUBLIC_DOMAIN