> ## Documentation Index
> Fetch the complete documentation index at: https://docs.presenton.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Fix common installation, provider, generation, document, and export problems.

## 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.

<Tip>
  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.
</Tip>