Custom settings

You can change the default settings by creating a settings.json file in runtipi/state/settings.json. This file makes your changes persist across restarts. Example file:


{
  "dnsIp": "9.9.9.9",
  "domain": "mydomain.com"
}

Be sure that the content is a valid JSON format. You can easily check for validity in an online tool like JSONLint

Available settings:

Parameter	Description	Type	Default value
`dnsIp`	The IP address of the DNS server to use. Legacy, kept for compatibility	`string`	`9.9.9.9`
`domain`	The domain name to use for the dashboard	`string`	`example.com`
`port`	The port to use for the dashboard	`integer`	`80`
`sslPort`	The port to use for the dashboard with SSL	`integer`	`443`
`listenIp`	The IP address to listen on	`string`	`automatically detected`
`appDataPath`	Base path to use for storing app data. Runtipi appends `/app-data` for you.	`string`	`runtipi`
`localDomain`	The domain name to use for local services	`string`	`tipi.lan`
`appsRepoUrl`	The URL to the apps repository	`string`	`https://github.com/runtipi/runtipi-appstore`
`postgresPort`	The port to use for the postgres database	`integer`	`5432`
`demoMode`	Enable demo restrictions. See security limitations.	`boolean`	`false`
`guestDashboard`	Allow guest access to the dashboard	`boolean`	`false`
`allowErrorMonitoring`	Whether the app will send anonymous crash reports to the Runtipi developers	`boolean`	`false`
`allowAutoThemes`	Enables thematically changing the dashboard based on the time of the year	`boolean`	`true`
`persistTraefikConfig`	Do not replace the Traefik config on every restart of Runtipi	`boolean`	`false`
`trustedProxyIps`	Comma-separated proxy IPs or CIDRs Traefik should trust for forwarded headers	`string`	empty
`eventsTimeout`	The time in minutes to wait for an action to complete before timing out	`integer`	`5`
`advancedSettings`	Show advanced settings in the dashboard	`boolean`	`false`
`forwardAuthUrl`	Override the Traefik forward-auth endpoint	`string`	`http://runtipi:3000/api/auth/traefik`
`logLevel`	Backend log level	`string`	`info`
`maxBackups`	Maximum number of backups to keep per app	`integer`	`0`
`timeZone`	Timezone used by Runtipi and many apps	`string`	system timezone
`themeBase`	Dashboard base theme	`string`	`gray`
`themeColor`	Dashboard accent color	`string`	`blue`
`experimental_insecureCookie`	Disable secure cookie handling for debugging only	`boolean`	`false`

Demo mode security limitations

Demo mode does not guarantee security or provide isolation from the host. A demo user may still find ways around its restrictions, including creating custom apps with root access to the host. Do not rely on demoMode to protect your server or data from untrusted users.

Only share demo access with people you trust with administrative access to the host. If you run a demo instance, use a separate, disposable host with no sensitive data or access to your private network.