Skip to main content

​
The application does not open

Run docker ps and docker logs presenton. Confirm the container is running, port 5001 is available, and the published port is 5001:80. If you used another host port, check the value before :80 in the Docker command or PRESENTON_HTTP_HOST_PORT in the Compose environment.

​
My presentations or settings disappeared

Confirm the replacement container mounts the same host folder to /app_data. A container started without that mount uses a new empty data directory.

​
The text provider cannot connect

  • Verify the provider URL, model name, and credentials.
  • Test the provider outside Presenton when possible.
  • For Ollama on the host, use host.docker.internal or a reachable network hostname—not container localhost.
  • Make sure the selected model is installed and available.

​
ChatGPT or Codex sign-in does not finish

  • Confirm Docker publishes both 5001:80 and 1455:1455.
  • Confirm LLM=codex and select a supported CODEX_MODEL.
  • Check that another local process is not already using port 1455.
  • Complete authentication from a browser that can reach http://localhost:1455/auth/callback.
  • For a remote Docker host, forward local ports 5001 and 1455 to the server before opening Presenton through http://localhost:5001.
Port 1455 is only the OAuth callback. The application, REST API, and MCP still use the normal Presenton web port.

​
Document upload succeeds but the content is poor

Use a clearer source, convert old office formats to DOCX/PPTX/XLSX, and check OCR language and DPI for scanned files. Very large or low-quality scans may need preprocessing.

​
Generation stops or returns malformed slides

Try a stronger structured-output model, simplify the prompt, reduce the slide count, and verify that the selected template is healthy. Check backend logs for provider or schema errors.

​
Export fails

Confirm /app_data is writable, the export runtime is present for the host architecture, and the application can open its internal render page. Check memory pressure and browser-rendering logs.

​
The AI assistant cannot make an edit

Ask for one specific change, name the slide, and make sure the requested object exists. Provider quality and template structure affect complex edits.

​
The API returns unauthorized

All /api/v1/* routes except /api/v1/auth/* require HTTP Basic authentication when the admin account is configured. Use the same username and password as the web UI and confirm that credential override has not changed them.

​
The MCP client returns unauthorized

Request a new bearer token from /api/v1/auth/login and update the client. Tokens are invalidated when credentials are rotated with AUTH_OVERRIDE_FROM_ENV=true. MCP is unavailable in the desktop app.
When asking for help, include the container image tag, operating system, Docker command or Compose profile, relevant logs, and the provider type—never include secrets.