Getting started
from the ZIP to your first video.

01Before you start

• A Linux server (VPS) with at least 2 CPU cores, 4 GB of memory and 20 GB of free disk (Requirements).
• A domain or subdomain, for example video.your-agency.com, pointing at the server's IP address.
• Docker installed on the server (docs.docker.com).
• Optional now, needed later: an Anthropic API key and an ElevenLabs API key (Keys).

02Ten steps

1. Upload and unpack Copy the Kinetica folder to the server, for example to /opt/kinetica, and open a terminal there.
2. Create the settings file cp .env.example .env
3. Fill in three values In .env: PUBLIC_URL=https://video.your-agency.com, ADMIN_SECRET_KEY= the output of openssl rand -hex 32, and TRUST_PROXY_HOPS=1. Save a copy of the secret key in your password manager now.
4. Build the image docker build -t kinetica .
5. Start it with the data volume and the port bound to localhost (command below).
6. Read the setup code docker logs kinetica prints a one-time code for the console.
7. Put https in front with Caddy (Deployment).
8. Create the console owner Open https://video.your-agency.com/admin, enter the code, your e-mail and a password.
9. Make your first studio account Console, Users, "Invite staff", or the create-user.js command (First steps).
10. Make a video Open /app, sign in, press New video.

cd /opt/kinetica
cp .env.example .env
openssl rand -hex 32          # paste the result into .env as ADMIN_SECRET_KEY
docker build -t kinetica .
docker volume create kinetica-data
docker run -d --name kinetica --restart unless-stopped \
  -p 127.0.0.1:8787:8787 --env-file .env \
  -v kinetica-data:/app/data kinetica
docker logs kinetica

The log ends with a line like [studio] 1.0.0 on http://localhost:8787 studio: /app console: /admin, and above it the one-time setup code:

[admin] No owner account yet. Open /admin and create it with this one-time setup code:

    XXXX-XXXX-XXXX-XXXX

03Then

1. Add your keys under Settings, Integrations in the console (Keys).
2. Set your brand: name, logo, accent colour (White label).
3. Decide what you sell and what each action costs (Plans and credits).
4. Turn on selling only after the Stripe webhook works (Stripe webhook).
5. Set up the nightly backup before real customers arrive (Backups).