#Configuration File

Disclaimer

This documentation may be obsolete, incomplete, or incorrect. Please refer to the default config.yaml in your installation for the most up-to-date list of settings.

WARNING: DO NOT EDIT THE DEFAULT CONFIG DIRECTLY. THIS WON'T HAVE ANY POSITIVE EFFECT. EDIT ITS COPY IN THE REPOSITORY ROOT INSTEAD.

config.yaml is the main configuration file for the SillyTavern server that you can find in the repository root directory after completing the installation. It is a YAML file that contains various settings, such as the network settings, security settings, and backend-specific options. The changes made to this file will take effect after restarting the server.

New settings that added to the upstream version will be automatically populated with the default values when you run npm install (or specifically, the post-install.js script) after updating the repository. You can then modify these settings as needed.

For nested settings, dot notation is used to indicate the hierarchy. For example, protocol.ipv6: false refers to the ipv6 setting under the protocol section with a value of false.

protocol:
  ipv6: false

#Data Configuration

Setting	Description	Default	Permitted Values
`dataRoot`	Root directory for user data storage	`./data`	Any valid directory path
`minLogLevel`	Minimum log level to display in the terminal	`0` (DEBUG)	(DEBUG = 0, INFO = 1, WARN = 2, ERROR = 3)
`cardsCacheCapacity`	The maximum amount of memory that parsed character cards can use in MB.	100	Any positive integer
`skipContentCheck`	Skip new default content checks	`false`	`true`, `false`
`enableDownloadableTokenizers`	Enable on-demand tokenizer downloads	`true`	`true`, `false`

#Network Configuration

Setting	Description	Default	Permitted Values
`listen`	Enable listening for incoming connections	`false`	`true`, `false`
`port`	Server listening port	`8000`	Any valid port number (1-65535)
`protocol.ipv4`	Enable listening on IPv4 protocol	`true`	`true`, `false`, `auto`
`protocol.ipv6`	Enable listening on IPv6 protocol	`false`	`true`, `false`, `auto`
`listenAddress.ipv4`	Listen on specific IPv4 address	`0.0.0.0`	Valid IPv4 address
`listenAddress.ipv6`	Listen on specific IPv6 address	`'[::]'`	Valid IPv6 address
`dnsPreferIPv6`	Prefer IPv6 for DNS resolution	`false`	`true`, `false`

#Security Configuration

Setting	Description	Default	Permitted Values
`whitelistMode`	Enable IP whitelist filtering	`true`	`true`, `false`
`enableForwardedWhitelist`	Check forwarded headers for whitelisted IPs	`true`	`true`, `false`
`whitelist`	List of allowed IP addresses	`["::1", "127.0.0.1"]`	Array of valid IP addresses
`enableCorsProxy`	Enable CORS proxy middleware	`false`	`true`, `false`
`allowKeysExposure`	Allow API keys exposure in the UI	`false`	`true`, `false`
`disableCsrfProtection`	Disable CSRF protection (not recommended)	`false`	`true`, `false`
`securityOverride`	Disable startup security checks (not recommended)	`false`	`true`, `false`

#User Authentication

Setting	Description	Default	Permitted Values
`basicAuthMode`	Enable basic authentication	`false`	`true`, `false`
`basicAuthUser.username`	Basic auth username	`"user"`	Any string
`basicAuthUser.password`	Basic auth password	`"password"`	Any string
`enableUserAccounts`	Enable multi-user mode	`false`	`true`, `false`
`enableDiscreetLogin`	Hide user list on login screen	`false`	`true`, `false`
`sessionTimeout`	User session timeout in seconds	`-1` (disabled)	Any number (-1 to disable, 0 for browser close, >0 for timeout)
`cookieSecret`	Secret for signing session cookies	`''` (auto-generated)	Any string
`autheliaAuth`	Enable Authelia-based auto login. See: SSO	`false`	`true`, `false`
`perUserBasicAuth`	Use account credentials for basic auth	`false`	`true`, `false`

#Request Proxy Configuration

Setting	Description	Default	Permitted Values
`requestProxy.enabled`	Enable proxy for outgoing requests	`false`	`true`, `false`
`requestProxy.url`	Proxy server URL	`null`	Valid proxy URL (e.g., `"socks5://username:password@example.com:1080"`)
`requestProxy.bypass`	Hosts to bypass proxy	`["localhost", "127.0.0.1"]`	Array of hostnames/IPs

#AutoRun Configuration

Setting	Description	Default	Permitted Values
`autorun`	Open browser automatically on startup	`true`	`true`, `false`
`autorunHostname`	Hostname used when autorun opens the browser	`"auto"`	`"auto"`, any valid hostname (e.g., `"localhost"`, `"st.example.com"`)
`autorunPortOverride`	Override port for browser autorun	`-1`	`-1` (use server port), any valid port number
`avoidLocalhost`	Avoid using 'localhost' for autorun	`false`	`true`, `false`

#Thumbnailing Configuration

Setting	Description	Default	Permitted Values
`thumbnails.enabled`	Enable thumbnail generation	`true`	`true`, `false`
`thumbnails.quality`	JPEG thumbnail quality	`95`	0-100
`thumbnails.format`	Image format for thumbnails	`jpg`	`jpg`, `png`
`thumbnails.dimensions.bg`	Background thumbnails size	`[160, 90]`	Array of two numbers (width, height)
`thumbnails.dimensions.avatar`	Avatar thumbnails size	`[96, 144]`	Array of two numbers (width, height)

#Backup Configuration

Setting	Description	Default	Permitted Values
`backups.chat.enabled`	Enable automatic chat backups	`true`	`true`, `false`
`backups.common.numberOfBackups`	Number of backups to keep	`50`	Any positive integer
`backups.chat.throttleInterval`	Backup throttle interval (ms)	`10000`	Any positive integer
`backups.chat.maxTotalBackups`	Maximum total chat backups to keep	`-1`	Any positive integer or -1

#Extensions Configuration

Setting	Description	Default	Permitted Values
`extensions.enabled`	Enable UI extensions	`true`	`true`, `false`
`extensions.autoUpdate`	Auto-update extensions	`true`	`true`, `false`
`extensions.models.autoDownload`	Enable automatic model downloads	`true`	`true`, `false`
`extensions.models.classification`	HuggingFace model ID for classification	`"Cohee/distilbert-base-uncased-go-emotions-onnx"`	Valid model ID
`extensions.models.captioning`	HuggingFace model ID for image captioning	`"Xenova/vit-gpt2-image-captioning"`	Valid model ID
`extensions.models.embedding`	HuggingFace model ID for embeddings	`"Cohee/jina-embeddings-v2-base-en"`	Valid model ID
`extensions.models.speechToText`	HuggingFace model ID for speech-to-text	`"Xenova/whisper-small"`	Valid model ID
`extensions.models.textToSpeech`	HuggingFace model ID for text-to-speech	`"Xenova/speecht5_tts"`	Valid model ID

#Server Plugins

Setting	Description	Default	Permitted Values
`enableServerPlugins`	Enable server-side plugins	`false`	`true`, `false`
`enableServerPluginsAutoUpdate`	Attempt to automatically update server plugins on startup	`true`	`true`, `false`

#API Integration Settings

#OpenAI Configuration

Setting	Description	Default	Permitted Values
`promptPlaceholder`	Default message for empty prompts	`"[Start a new chat]"`	Any string
`openai.randomizeUserId`	Randomize user ID for API calls	`false`	`true`, `false`
`openai.captionSystemPrompt`	System message for caption completion	`""`	Any string

#MistralAI Configuration

Setting	Description	Default	Permitted Values
`mistral.enablePrefix`	Enable reply prefilling. The prefix will be echoed in the response	`false`	`true`, `false`

#Ollama Configuration

Setting	Description	Default	Permitted Values
`ollama.keepAlive`	Model keep-alive duration (seconds)	`-1`	`-1` (indefinite), `0` (immediate unload), positive integer
`ollama.batchSize`	Controls the "num_batch" (batch size) parameter of the generation request	`-1`	`-1` (model default), positive integer

#Claude Configuration

IMPORTANT!

Use with caution and only when the prompt prefix is static and doesn't change between requests. {{random}} macro, lorebooks, vectors, summaries, etc. will likely invalidate the cache and you'll just waste money on cache misses. Behavior may be unpredictable and no guarantees can or will be made.

See: Prompt Caching

Setting	Description	Default	Permitted Values
`claude.enableSystemPromptCache`	Enable system prompt caching	`false`	`true`, `false`
`claude.cachingAtDepth`	Enable message history caching	`-1`	`-1` (disabled), `0` or positive integer

#DeepL Configuration

Setting	Description	Default	Permitted Values
`deepl.formality`	Translation formality level	`"default"`	`"default"`, `"more"`, `"less"`, `"prefer_more"`, `"prefer_less"`