Docker Compose Quickstart - Speckle Docs

This Docker Compose path is for development, evaluation, and testing. Speckle does not recommend Docker Compose for production deployments. For a customer-operated production environment, use Kubernetes. Speckle Enterprise Server also requires Kubernetes.

Prerequisites

Linux VM with at least 4GB RAM
x86_64 CPU architecture
Docker and Docker Compose installed

Quick Start

1

Create Directory

mkdir /opt/speckle/
cd /opt/speckle/

2

Create Docker Compose File

Create a file named docker-compose.yml with the following content:

version: '2.3'
name: 'speckle-server'

services:
  postgres:
    image: 'postgres:18.3-alpine3.23'
    restart: always
    environment:
      POSTGRES_DB: speckle
      POSTGRES_USER: speckle
      POSTGRES_PASSWORD: speckle
    volumes:
      - ./postgres-data:/var/lib/postgresql/data/

  redis:
    image: 'valkey/valkey:8-alpine'
    restart: always
    volumes:
      - ./redis-data:/data

  minio:
    image: 'minio/minio'
    command: server /data --console-address ":9001"
    restart: always
    ports:
      - '127.0.0.1:9000:9000'
    volumes:
      - ./minio-data:/data

  speckle-ingress:
    image: speckle/speckle-docker-compose-ingress:latest
    restart: always
    ports:
      - '127.0.0.1:80:8080'

  speckle-frontend-2:
    image: speckle/speckle-frontend-2:latest
    restart: always
    environment:
      NUXT_PUBLIC_SERVER_NAME: 'local'
      NUXT_PUBLIC_API_ORIGIN: 'http://127.0.0.1'
      NUXT_PUBLIC_BACKEND_API_ORIGIN: 'http://speckle-server:3000'
      NUXT_PUBLIC_BASE_URL: 'http://127.0.0.1'
      NUXT_REDIS_URL: 'redis://redis'
      # Set to true if running it w/ SSL
      NUXT_PUBLIC_SSL_ENABLED: 'false'

  speckle-server:
    image: speckle/speckle-server:latest
    restart: always
    depends_on:
      - postgres
      - redis
      - minio
    environment:
      CANONICAL_URL: 'http://127.0.0.1'
      SESSION_SECRET: 'your-secret-key-here'
      STRATEGY_LOCAL: 'true'
      POSTGRES_URL: 'postgres'
      POSTGRES_USER: 'speckle'
      POSTGRES_PASSWORD: 'speckle'
      POSTGRES_DB: 'speckle'
      # File-import jobs are queued in this database; must match the ifc-import-service below
      FILEIMPORT_QUEUE_POSTGRES_URL: 'postgresql://speckle:speckle@postgres/speckle'
      # Required on public Speckle Server releases so IFC jobs are queued for ifc-import-service
      FF_NEXT_GEN_FILE_IMPORTER_ENABLED: 'true'
      REDIS_URL: 'redis://redis'
      S3_ENDPOINT: 'http://minio:9000'
      S3_PUBLIC_ENDPOINT: 'http://127.0.0.1:9000'
      S3_ACCESS_KEY: 'minioadmin'
      S3_SECRET_KEY: 'minioadmin'
      S3_BUCKET: 'speckle-server'
      FRONTEND_ORIGIN: 'http://127.0.0.1'
      EMAIL: 'true'
      EMAIL_HOST: 'your-email-host-domain-here'
      EMAIL_PORT: '587' # or another SMTP compatible port as defined by your transactional (SMTP relay) email provider
      EMAIL_USERNAME: 'your-email-service-username'
      EMAIL_PASSWORD: 'your-email-service-password'
      EMAIL_SECURE: 'false' # enable to require SSL (Note that TLS is often preferred; see EMAIL_REQUIRE_TLS)
      EMAIL_REQUIRE_TLS: 'true' # enable to require TLS. Disable if SSL is used instead.
      EMAIL_FROM: 'an-email-address-you-own-and-configured-with-your-transactional-email-provider@example.org'

  preview-service:
    image: speckle/speckle-preview-service:latest
    restart: always
    depends_on:
      - speckle-server
    environment:
      REDIS_URL: 'redis://redis'

  webhook-service:
    image: speckle/speckle-webhook-service:latest
    restart: always
    depends_on:
      - speckle-server
    environment:
      PG_CONNECTION_STRING: 'postgres://speckle:speckle@postgres/speckle'

  ifc-import-service:
    image: speckle/speckle-ifc-import-service:latest
    restart: always
    depends_on:
      - speckle-server
    environment:
      FILEIMPORT_QUEUE_POSTGRES_URL: 'postgresql://speckle:speckle@postgres/speckle'

3

Start the Server

docker compose up -d

Access Your Server

Once running, access your Speckle server at:

Frontend: http://your-server-ip
MinIO Console: http://your-server-ip:9001 (credentials: minioadmin/minioadmin)

Next Steps

Create your first user by visiting the frontend URL
Configure your server - a full example is part of the server repo
Use non-default credentials and secrets before sharing the environment with other testers
Review logs and resource use while evaluating your expected workload

Getting Help

Community Forum: speckle.community
Professional Support: https://speckle.systems/pricing/

Do not promote this Docker Compose environment into production. Use the Kubernetes deployment guide to design a customer-operated production environment.

Last modified on August 16, 2026