Install with Docker

Deploy Open VTS using Docker and Docker Compose for quick setup and easy updates.

Last updated March 15, 2026

Docker is the fastest way to get Open VTS running. This guide uses Docker Compose to set up both the application and database in under 5 minutes.

Prerequisites

Docker Engine 20.10+
Docker Compose v2.0+
At least 2 GB of available RAM

Docker Compose Setup

Create a docker-compose.yml file in your project directory:

docker-compose.yml

version: "3.8"

services:
  openvts:
    image: openvts/openvts:latest
    container_name: openvts
    restart: unless-stopped
    ports:
      - "8082:8082"
      - "8443:8443"
      - "5055-5190:5055-5190"
    volumes:
      - ./data/openvts:/opt/openvts/data
      - ./data/logs:/opt/openvts/logs
    environment:
      - DATABASE_URL=jdbc:postgresql://db:5432/openvts
      - DATABASE_USER=openvts
      - DATABASE_PASSWORD=${DB_PASSWORD}
    depends_on:
      db:
        condition: service_healthy

  db:
    image: postgres:16-alpine
    container_name: openvts-db
    restart: unless-stopped
    volumes:
      - pgdata:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=openvts
      - POSTGRES_USER=openvts
      - POSTGRES_PASSWORD=${DB_PASSWORD}
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U openvts"]
      interval: 5s
      timeout: 5s
      retries: 5

volumes:
  pgdata:

Environment Variables

Create a .env file alongside your compose file:

.env

DB_PASSWORD=your_secure_password_here

Danger

Never commit .env files to version control. Add it to your .gitignore.

Launch the Stack

terminal

# Start all services in detached mode
docker compose up -d

# Verify services are running
docker compose ps

# View application logs
docker compose logs -f openvts

Updating

terminal

# Pull the latest image and restart
docker compose pull
docker compose up -d

Tip

Your data is stored in Docker volumes and the ./data directory, so updates preserve all your configuration and tracking data.

Install with Docker

Deploy Open VTS using Docker and Docker Compose for quick setup and easy updates.

Last updated March 15, 2026

Docker is the fastest way to get Open VTS running. This guide uses Docker Compose to set up both the application and database in under 5 minutes.

Prerequisites

Docker Engine 20.10+
Docker Compose v2.0+
At least 2 GB of available RAM

Docker Compose Setup

Create a docker-compose.yml file in your project directory:

docker-compose.yml

version: "3.8"

services:
  openvts:
    image: openvts/openvts:latest
    container_name: openvts
    restart: unless-stopped
    ports:
      - "8082:8082"
      - "8443:8443"
      - "5055-5190:5055-5190"
    volumes:
      - ./data/openvts:/opt/openvts/data
      - ./data/logs:/opt/openvts/logs
    environment:
      - DATABASE_URL=jdbc:postgresql://db:5432/openvts
      - DATABASE_USER=openvts
      - DATABASE_PASSWORD=${DB_PASSWORD}
    depends_on:
      db:
        condition: service_healthy

  db:
    image: postgres:16-alpine
    container_name: openvts-db
    restart: unless-stopped
    volumes:
      - pgdata:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=openvts
      - POSTGRES_USER=openvts
      - POSTGRES_PASSWORD=${DB_PASSWORD}
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U openvts"]
      interval: 5s
      timeout: 5s
      retries: 5

volumes:
  pgdata:

Environment Variables

Create a .env file alongside your compose file:

.env

DB_PASSWORD=your_secure_password_here

Danger

Never commit .env files to version control. Add it to your .gitignore.

Launch the Stack

terminal

# Start all services in detached mode
docker compose up -d

# Verify services are running
docker compose ps

# View application logs
docker compose logs -f openvts

Updating

terminal

# Pull the latest image and restart
docker compose pull
docker compose up -d

Tip

Your data is stored in Docker volumes and the ./data directory, so updates preserve all your configuration and tracking data.