SkySend | Docs

Appearance

Docker Setup ​

This guide covers the Docker deployment of SkySend in detail.

The simplest way to run SkySend is with Docker Compose:

yaml
services:
  skysend:
    build: .
    restart: always
    ports:
      - "${PORT:-3000}:3000"
    volumes:
      - ./data:/data
      - ./uploads:/uploads
    env_file:
      - .env
    environment:
      - BASE_URL=https://send.example.com
      - DATA_DIR=/data
      - UPLOADS_DIR=/uploads
      - PUID=${PUID:-1001}
      - PGID=${PGID:-1001}

Start with:

bash
docker compose up -d

Environment Variables ​

Pass environment variables via .env file or directly:

bash
# .env
BASE_URL=https://send.example.com
PORT=3000
MAX_FILE_SIZE=2GB
DEFAULT_EXPIRE_SEC=86400
UPLOAD_QUOTA_BYTES=10737418240  # 10 GB per user per day

See Environment Variables for the complete reference.

Data Persistence ​

SkySend uses two separate volumes:

VolumeContainer PathContent
Database/dataSQLite database at /data/db/skysend.db
Uploads/uploadsEncrypted upload files
./data/                  # Mount to /data
  db/
    skysend.db           # SQLite database + WAL files
./uploads/               # Mount to /uploads
  <uuid>.bin             # Encrypted upload files

Backups

To back up SkySend, copy both the data/ and uploads/ directories. The SQLite database uses WAL mode, so it is safe to copy while the server is running.

Building the Image ​

SkySend uses a multi-stage Dockerfile:

  1. base - Node.js 24 Alpine with pnpm
  2. build - Installs all dependencies and builds the project
  3. deploy - Production image with only runtime dependencies
bash
docker build -t skysend .

The final image contains:

  • Built server (apps/server/dist)
  • Built frontend (apps/web/dist)
  • Production dependencies only
  • Non-root user (skysend, UID 1001)
  • Health check on /api/health

Custom Port ​

To run on a different port:

bash
PORT=8080 docker compose up -d

Or in your .env:

bash
PORT=8080

Updating ​

To update to a new version:

bash
git pull
docker compose build
docker compose up -d

Your data is preserved in the mounted volume.