Custom settings

You can change the default settings by creating a settings.json file. The file should be located in the runtipi/state directory. This file will make 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`	`localhost`
`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`	The path to use for storing data	`string`	`runtipi/app-data`
`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`	Start runtipi in demo mode	`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`	`true`
`allowAutoTheme`	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`	`true`
`eventsTimeout`	The time in minutes to wait for an action to complete before timing out	`integer`	`5`

Using the CLI Custom Environment Variables

Need more help? Visit our forums to get help from the community.