Self-host Presenton in five minutes

This path gets one self-hosted instance running locally. You need Docker and credentials for a supported text provider, or a reachable local model.

1. Start Presenton

Linux and macOS
Windows PowerShell

mkdir -p app_data

docker run --detach --name presenton \
  --publish 5001:80 \
  --volume "./app_data:/app_data" \
  ghcr.io/presenton/presenton:v0.9.0-beta

New-Item -ItemType Directory -Force app_data

docker run --detach --name presenton `
  --publish 5001:80 `
  --volume "${PWD}\app_data:/app_data" `
  ghcr.io/presenton/presenton:v0.9.0-beta

The host folder is mounted at /app_data so presentations and settings survive container replacement.

2. Open the application

Visit http://localhost:5001. If the page does not load, check:

docker ps --filter name=presenton
docker logs --tail 100 presenton

3. Connect a text provider

Follow the first-run Settings flow and choose a provider. For the shortest hosted-provider setup, enter an API key and supported model in the application. To keep administrator-supplied credentials out of the UI, restart with environment variables instead:

docker stop presenton
docker rm presenton

docker run --detach --name presenton \
  --publish 5001:80 \
  --env LLM=openai \
  --env OPENAI_API_KEY="YOUR_API_KEY" \
  --env OPENAI_MODEL=gpt-4.1 \
  --env CAN_CHANGE_KEYS=false \
  --volume "./app_data:/app_data" \
  ghcr.io/presenton/presenton:v0.9.0-beta

Do not paste real keys into source files or commit a .env file. Use your deployment platform’s secret manager for a remote instance.

4. Generate and persist a test deck

Create a short two- or three-slide presentation. Restart the container with docker restart presenton, reopen the dashboard, and confirm the deck remains available.

The application loads, a text provider generates a deck, export completes, and the deck remains after restart.

5. Choose the next path

Complete Docker setup

Add Compose, authentication, GPU access, and repeatable operations.

Deploy to a cloud platform

Use Railway or DigitalOcean and configure persistence and secrets.

Review environment variables

Configure providers, storage, memory, processing, and access.

Secure a shared instance

Enable the administrator account before exposing the service remotely.

Getting started

Deploy

Configure

Production

1. Start Presenton

2. Open the application

3. Connect a text provider

4. Generate and persist a test deck

5. Choose the next path

Complete Docker setup

Deploy to a cloud platform

Review environment variables

Secure a shared instance

​1. Start Presenton

​2. Open the application

​3. Connect a text provider

​4. Generate and persist a test deck

​5. Choose the next path

Complete Docker setup

Deploy to a cloud platform

Review environment variables

Secure a shared instance

1. Start Presenton

2. Open the application

3. Connect a text provider

4. Generate and persist a test deck

5. Choose the next path