Quick Start

Replace all placeholder secrets before going public.

Copy the environment file

cp .env.example .env

Set at least:

Auth__Jwt__Secret=replace-with-a-strong-random-secret-32chars-min
Auth__BootstrapSuperAdmin__Username=admin
Auth__BootstrapSuperAdmin__Password=replace-with-a-strong-password
FRONTEND_VITE_API_BASE_URL=http://localhost:5121

Enable API keys if you plan to use MCP or scripts:

Auth__ApiKey__Enabled=true
Auth__ApiKey__Keys__0=replace-with-a-strong-random-api-key

Start the stack

docker compose up -d --build

Verify the backend

curl http://localhost:5121/api/v1/system/ping
curl http://localhost:5121/api/v1/system/bootstrap

bootstrap returns runtime config such as apiKeyRequired, maxUploadSizeBytes, and allowedContentTypes. It does not confirm whether a SuperAdmin was created.

Open http://localhost:5173/login and sign in with the bootstrap credentials from .env.

Upload your first image

Open http://localhost:5173/assets, upload an image, and optionally make it public.After the upload you can open /workflows to configure reusable workflow profiles and decide whether they should run automatically for new assets.

Browse the gallery

Open http://localhost:5173/gallery.

Next steps

Deployment

Production topology, reverse proxies, domains, and HTTPS.

Workflows

Configure workflow profiles, auto-run behavior, and manual execution from asset details.

Storage providers

Local, S3-compatible, and GitHub Repo storage options.

Introduction

Deployment

Get Started

Core Concepts

Guides

Configuration

Next steps

Deployment

Workflows

Storage providers

​Next steps

Deployment

Workflows

Storage providers

Next steps