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
    environment:
      EDGE_KEY: "eyJzZXJ2ZXJVcmwiOiJodHRwOi8vbG9jYWxob3N0Ojg4ODciLCJhZ2VudElkIjoiY200cXc4MGNoMDAwNzF4MjhlMmpmcW5wcCJ9"
    networks:
      - portabase

  db:
    image: postgres:17-alpine
    networks:
      - portabase
      - default
    ports:
      - "5430:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=devdb
      - POSTGRES_USER=devuser
      - POSTGRES_PASSWORD=changeme

volumes:
  postgres-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.