---
url: https://panomc.com/docs/platform/configuration/production.md
---
# Production Setup

## Production Checklist

* `development-mode = false`
* Port **80 (TCP)** open and reachable
* HTTPS enabled (via Pano SSL or Reverse Proxy) and Port **443 (TCP)** open
* Secure and private `jwt-key`
* Valid SMTP credentials configured
* Database prefix unchanged post-install
* Correct theme ID set or falls back to Vanilla Theme
* Regular backups for database and uploads
* [Maintenance mode](../../maintenance/) tested once before you need it — know your bypass permission and your login URL
* `server.trusted-proxies` filled in **if Pano sits behind a reverse proxy** (`"cloudflare"` covers Cloudflare).
  Left empty, a public proxy's address is taken for every visitor, and the maintenance login — which believes
  `X-Forwarded-For` only from listed proxies — bans and rate-limits one address instead of your visitors'
* If any **Minecraft servers** connect through that same reverse proxy, its WebSocket idle timeout is longer
  than Pano's heartbeat (`heartbeat-interval` / `heartbeat-timeout`, default **25s** / **75s**) — see
  [Reverse Proxy WebSocket Keepalive](../server/#reverse-proxy-websocket-keepalive). If you tune those
  values, keep them within the accepted ranges documented there — an out-of-range pair is not applied:
  Pano logs a warning, falls back to the 25s / 75s defaults and starts normally

## Example Minimal Configuration

```jsonc
development-mode = false
locale = "en-US"

website-name = "My Awesome Server"
website-description = "Survival • Events • Friendly Community"
support-email = "support@myserver.com"

server-ip-address = "mc.myserver.com"
server-game-version = "1.20.x"

database {
  host = "127.0.0.1:3306"
  name = "pano_prod"
  username = "pano_user"
  password = ""
  prefix = "pano_"
}

current-theme = "vanilla-theme"

email {
  enabled = true
  sender = "Pano <no-reply@myserver.com>"
  hostname = "smtp.myserver.com"
  port = 465
  username = "no-reply@myserver.com"
  password = "REPLACE_ME"
  ssl = true
}

server {
  host = "0.0.0.0"
  http-port = 80
}
```

## After Editing

* Save and **restart Pano** after editing.
* Avoid changing auto-generated fields (e.g., `jwt-key`, `config-version`).
* Check for syntax issues if startup fails.
* Always back up before upgrading or reinstalling.

> Need help? Visit the FAQ, join our [Discord community](https://discord.gg/6vVy72wgXT), or report issues
> on [GitHub](https://github.com/PanoMC/Pano/issues).