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 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. Leave it empty and Pano ignores X-Forwarded-For entirely, so every request looks like it comes from the proxy — the maintenance login's IP ban and rate limit then see 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. 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

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"
  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, or report issues on GitHub.