Skip to content

Server Configuration

Server Settings

jsonc
server {
  host = "0.0.0.0"
  http-port = 80
  https-port = 443
  ssl-mode = "DISABLED" # "DISABLED", "LETS_ENCRYPT", "MANUAL"
  redirect-https = false
  ssl-cert = null # Raw certificate content (if MANUAL)
  ssl-key = null  # Raw private key content (if MANUAL)
}
  • host: 0.0.0.0 makes the panel accessible to external networks; 127.0.0.1 restricts access to local only.
  • http-port: Default port for HTTP traffic (usually 80).
  • https-port: Default port for HTTPS traffic (usually 443).
  • ssl-mode:
    • DISABLED: No HTTPS server will be started.
    • LETS_ENCRYPT: Automatically attempts to obtain and configure an SSL certificate. Note: For this to work, a valid website-url must be configured, http-port must be set to 80, and https-port must be set to 443.
    • MANUAL: Allows you to provide your own certificate and key strings directly via ssl-cert and ssl-key.
  • redirect-https: If set to true, all HTTP traffic will be automatically redirected to HTTPS.
  • Advanced: For complex setups, you can still use a reverse proxy (Nginx, Apache) or Cloudflare.

Initialization, UI, and Updates

jsonc
init-ui = true
accept-plugin-auth = true
jwt-key = "<auto-generated-base64>"
update-period = "ONCE_PER_DAY" # "ONCE_PER_DAY" or "ONCE_PER_WEEK" or "ONCE_PER_MONTH"
release-channel = "RELEASE" # "ALPHA", "BETA", "RELEASE"
console-history-limit = 50

Details

  • init-ui: launches the setup wizard, panel, and theme engine at startup.
  • accept-plugin-auth: enables/disables the connection of the Pano MC plugin (default: true). Can be managed from the Connect Server modal. For better security, disable it if not in use.
  • jwt-key: auto-generated Base64 authentication keydo not modify manually.
  • update-period: defines update-check frequency.
  • release-channel: determines which update stream Pano follows:
    • ALPHA: Early access to new features. High risk of bugs and breaking changes.
    • BETA: Pre-release features with lower risk than Alpha, but may still contain bugs.
    • RELEASE: Most stable version. Receives updates less frequently but ensures maximum reliability.
  • console-history-limit: defines the maximum number of commands to store in the terminal and GUI console history (default: 50, set to 0 to disable).

File Uploads and Paths

jsonc
file-uploads-folder = "file-uploads"

file-paths = {
  favicon {
    path = "uploads/favicon.png"
    hash = "<sha256-hash>"
  }
  websiteLogo {
    path = "uploads/logo.png"
    hash = "<sha256-hash>"
  }
}

Notes

  • Controlled by Panel → Settings → Website.
  • Each entry is a FileInfo object containing:
    • path: Relative path to the file.
    • hash: SHA-256 hash used by Pano to verify file integrity.
  • Only supports two entries: favicon and websiteLogo.
  • These fields are automatically managed by Pano — manual edits are overwritten on updates or settings changes.

Pano Service URLs (Do Not Modify)

jsonc
pano-api-url = "..."     # auto-set based on environment
pano-website-url = "..."
  • These are managed by Pano automatically.
  • Changing them can break connectivity with the Pano ecosystem.

Setup Progress (Internal)

jsonc
setup {
  step = 0
}

Usage

  • Tracks installation progress.
  • Always stop Pano before editing.
  • step = 0: restarts the setup wizard.
  • step = 5: marks setup as complete.
  • Only modify if instructed by support; improper edits may cause broken installations.