Skip to main content
Presenton can run as a personal desktop application, a browser-based Docker service, or an authenticated API and MCP service for a team.

​
Compare the options

​
Container contract

Every container deployment should preserve these invariants:
  • Publish container port 80; the recommended host port is 5001.
  • Publish 1455:1455 as well when users will authenticate through Sign in with ChatGPT.
  • Mount persistent storage at /app_data.
  • Store credentials in environment variables or a secret manager.
  • Configure HTTPS before serving remote users.
  • Keep the API and MCP endpoint behind Presenton authentication and network controls.

​
Docker Compose profiles

The source repository defines production, production-gpu, development, and development-gpu services. Put environment variables in .env beside docker-compose.yml.
Set another host port with:
Port 1455 is also mapped by the repository’s Compose configuration for the Codex OAuth callback. It is required for users who want to use an eligible existing ChatGPT/Codex subscription without an OpenAI API key. It is not the Presenton web or MCP port.

​
Desktop deployment

The Electron application packages the interface and backend for macOS, Windows, and Linux. It accepts the same provider concepts, but it is designed for local interactive use: the MCP server is disabled and authentication is disabled by default to avoid conflicts with the desktop runtime.

Install the desktop app

Choose the correct installer for macOS, Windows, or Linux.

​
GPU deployment

Install the NVIDIA Container Toolkit and use --gpus=all or the production-gpu Compose service. Verify GPU access independently before troubleshooting Presenton.
GPU access is primarily useful when a compatible local runtime performs model or image work. Hosted providers execute in the provider’s infrastructure.

​
Deploy in your cloud account

The project README provides quick-deploy paths for Railway and DigitalOcean. The same container can run on other VM or container platforms when the platform supports a persistent disk and port mapping. For any platform:
  1. Deploy ghcr.io/presenton/presenton:v0.9.0-beta or an intentionally selected image digest.
  2. Route HTTPS traffic to container port 80.
  3. Mount a persistent disk at /app_data.
  4. Supply provider and authentication settings through platform secrets.
  5. Configure health monitoring and container restart behavior.
  6. Back up the disk and any external database.
  7. Test UI, API, export, and MCP workflows after each upgrade.

​
Local is not automatically offline

Running Presenton locally does not prevent data from reaching configured hosted text, image, or search providers. For local-first processing:
  • Use Ollama or LM Studio for text.
  • Use ComfyUI for generated images, or disable image generation.
  • Use SearXNG for self-hosted search, or disable web grounding.
  • Review presentation memory and telemetry settings.

Installation guide

Follow complete Docker, Compose, desktop, and GPU installation paths.

Configuration overview

Configure providers, authentication, storage, search, and processing.