Docker Deployment

This page documents ElastOS v1 (PC2), the proof of concept. ElastOS v2 is the current system. To install it, see Install ElastOS. To see how the stages fit together, see ElastOS in stages.

Run PC2 in a Docker container for easy deployment and isolation.

Quick Start

# Create data directories
mkdir -p pc2/data pc2/config
 
# Run container
docker run -d \
  --name pc2-node \
  -p 4200:4200 \
  -v $(pwd)/pc2/data:/app/data \
  ghcr.io/elacity/pc2:latest
 
# Check status
docker logs -f pc2-node

Open http://localhost:4200 in your browser.

Docker Compose

Create docker-compose.yml:

version: '3.8'
 
services:
  pc2:
    image: ghcr.io/elacity/pc2:latest
    container_name: pc2-node
    ports:
      - "4200:4200"
    volumes:
      - ./data:/app/data
    environment:
      - NODE_ENV=production
    restart: unless-stopped

Then run:

docker compose up -d

Build from Source

If you want to build the image yourself:

# Clone repository
git clone https://github.com/Elacity/pc2.net
cd pc2.net
 
# Build image
docker build -t pc2-node -f pc2-node/Dockerfile .
 
# Run
docker run -d -p 4200:4200 -v $(pwd)/data:/app/data pc2-node

Environment Variables

VariableDefaultDescription
PORT4200HTTP port
NODE_ENVproductionEnvironment
PC2_DATA_DIR/app/dataData directory

Volumes

Container PathPurpose
/app/dataUser files, database, identity
⚠️

Important: Always mount /app/data to persist your data across container restarts.

Managing the Container

# View logs
docker logs -f pc2-node
 
# Stop
docker stop pc2-node
 
# Start
docker start pc2-node
 
# Restart
docker restart pc2-node
 
# Remove
docker rm -f pc2-node

Updating

# Pull latest image
docker pull ghcr.io/elacity/pc2:latest
 
# Stop and remove old container
docker stop pc2-node
docker rm pc2-node
 
# Run new container
docker run -d \
  --name pc2-node \
  -p 4200:4200 \
  -v $(pwd)/pc2/data:/app/data \
  ghcr.io/elacity/pc2:latest

Or with Docker Compose:

docker compose pull
docker compose up -d

Adding HTTPS with Caddy

Create docker-compose.yml with Caddy:

version: '3.8'
 
services:
  pc2:
    image: ghcr.io/elacity/pc2:latest
    expose:
      - "4200"
    volumes:
      - ./data:/app/data
    restart: unless-stopped
 
  caddy:
    image: caddy:2-alpine
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - caddy_data:/data
    restart: unless-stopped
 
volumes:
  caddy_data:

Create Caddyfile:

yourdomain.com {
    reverse_proxy pc2:4200
}

Then:

docker compose up -d

→ Need more control? See From Source

© 2026 Elacity Labs. ELASTOS® is a registered trademark of Elastos DAO. ElastOS is open source under the MIT licence.