Skip to content

Example

Make a directory tree available for your docker container to mount:

1. Create directories
/my/docker/files/
    | - data/
    | - init/
        | - micronaut/
            | - application-mauro.yml

Where data/ is going to be where the Postgres database files are kept, and init/micronaut/ is where the configuration application-mauro.yml is going to go.

(The data/ directory does not need to be at the same location)

2. Configure users, groups, API keys

Fill in application-mauro.yml with some configuration:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
mauro:
  users:
    -   email: admin@maurodatamapper.com
        first-name: admin
        last-name: admin
        temp-password: a_password
  groups:
    -   name: Administrators
        is-admin: true
        members:
          - admin@maurodatamapper.com
  api-keys:
    -   name: My first API Key
        email: admin@maurodatamapper.com
        refreshable: true
        expiry: 2027-12-31
3. Pull a docker image
Tag Architectures Size (MB) Last Updated Pull Command
0.0.2-beta amd64, arm64, unknown 510.7 2026-03-05T17:35:00.588361Z docker pull maurodatamapper/mauro:0.0.2-beta
0.0.1-beta arm64 237.8 2025-09-22T15:30:20.67264Z docker pull maurodatamapper/mauro:0.0.1-beta 
1
docker pull maurodatamapper/mauro:0.0.2-beta
4. Start the container

Start the container with user interface port open and the local directories mounted:

1
2
3
4
5
docker run --rm -p 8080:8080 \
  -v /my/docker/files/init:/opt/init:ro \
  -v /my/docker/files/data:/var/lib/postgresql/data \
  -it \
  maurodatamapper/mauro:0.0.2-beta

(The above will start the container in the foreground - which is useful for seeing trace and interacting through the terminal. Read Running to find a detailed description of the docker command, for example running the container in the background.)

5. View user interface in browser

Visit http://yourhostname:8080/ in your browser.

The above application-mauro.yml has some mauro: configuration for users, groups, and API keys. Sign in with those credentials. In the above example that would be:

admin@maurodatamapper.com
a_password

Behaviours to note
  • Stopping the container will cause it to shutdown cleanly: it is safe to do that.
  • Running The docker run command using the same parameters will start it again. The data will persist in /my/docker/files/data
  • You can edit the start up files, and restart the container again.
  • Updating You can replace the docker image with a newer version using the docker pull command, stop the previous container, and start the new one.