Install with Docker

You wil found all the necessary about the docker configuration

Anything unclear or buggy in this tutorial? Please report it!

Requirements

• Docker official documentation
• Docker compose

The config file

Create a file docker-compose.yml:

name: agent-portabase

services:
  app:
    container_name: agent-portabase
    restart: always
    image: solucetechnologies/agent-portabase:latest
    volumes:
      - ./databases.json:/app/src/data/config/config.json
      # - ./databases.toml:/app/src/data/config/config.toml
    environment:
      TZ: "Europe/Paris"
      # DATABASES_CONFIG_FILE: "config.toml" if you use .toml config file. By default, it's "config.json"
      EDGE_KEY: "<Get your edge key from your dashboard>"
    #network_mode: host #in development
    networks:
      - portabase

  db:
    image: postgres:17-alpine
    networks:
      - portabase
      - default
    ports:
      - "5430:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data
    #network_mode: host #in development
    environment:
      - POSTGRES_DB=<your_database>
      - POSTGRES_USER=<database_user>
      - POSTGRES_PASSWORD=<database_password>

  db2:
    image: mariadb:latest
    ports:
      - "3306:3306"
    environment:
      - MYSQL_DATABASE=<your_database>
      - MYSQL_USER=<database_user>
      - MYSQL_PASSWORD=<database_password>
      - MYSQL_RANDOM_ROOT_PASSWORD=yes
    volumes:
      - mariadb-data:/var/lib/mysql
    #network_mode: host #in development

volumes:
  postgres-data:
  mariadb-data:

networks:
  portabase:
    name: portabase_network
    external: true

Start the service

After you have created the docker-compose.yml file, run the following command:

docker compose up -d 

You can now return to your Portabase instance dashboard (in the agent section) to verify that the database has been created.

From now on, you can register databases within workspace projects. Agents are pinging the dashboard server every minute.