Deployment Guide

ClipAce is designed for a VPS or container host for the MVP because it needs local disk, large uploads, and ffmpeg processing.

Docker Compose

docker compose up -d --build

The compose stack runs:

• Next.js app on container port `3000`.
• Host mapping on `127.0.0.1:3021`.
• Persistent app storage in `./storage`.

Before starting the app, make sure the storage directory is writable by the container user:

mkdir -p storage
chown -R 1001:1001 storage

Nginx

Use `deploy/nginx.clipace.conf` as the nginx server block for `ace.codekey.top`. The server block proxies to `127.0.0.1:3021` and raises upload and proxy timeouts for video processing.

Domain

Point `ace.codekey.top` to the server IP. During MVP testing, a DNS-only record is preferred so large uploads are not constrained by Cloudflare proxy limits.

Server Checklist

• Ports `80`, `443`, and `22` are open.
• Docker and Docker Compose are installed.
• At least 20 GB free disk for testing uploads.
• `./storage` is not deleted between deploys.
• Add a cleanup job before wider public testing.