General
| Variable | Description | Default |
|---|---|---|
DEGOOG_PORT |
Port the server listens on | 4444 |
DEGOOG_SETTINGS_PASSWORDS |
Comma-separated list of passwords for the Settings page. If set, users must enter one of these to access Settings (unless a middleware plugin is used as the settings gate). | — |
DEGOOG_PUBLIC_INSTANCE |
When set to a truthy value (e.g. true,
1), the instance runs in read-only mode: settings
show only theme and engine toggles, no tabs; all server-side
mutation APIs return Unauthorized.
|
— |
DEGOOG_DISTRUST_PROXY |
When set to a truthy value (e.g. true,
1), ignores X-Forwarded-For and
X-Real-IP headers for rate limiting. Set this if
degoog is exposed directly to the internet without a reverse
proxy, to prevent clients from spoofing their IP.
|
— |
DEGOOG_DEFAULT_SEARCH_LANGUAGE |
Default ISO 639-1 language code applied to all searches when no
language is selected by the user (e.g. en,
de, it).
|
en-US |
DEGOOG_I18N |
Forces the UI locale for all requests, overriding the
Accept-Language header (e.g. en-US,
fr-FR). When set, the same locale pipeline runs as
normal — only the source changes. Unset or empty:
Accept-Language is used as today.
|
— |
LOG_LEVEL |
Controls the verbosity of server-side console output. Supported
levels from most to least severe:
fatal, error, warn,
info, log, debug. Each
level includes all levels of higher severity. Set to
debug to print all messages, including plugin
execution times. If you use docker you can view your logs with
docker compose logs -f.
|
info |
Docker
| Variable | Description | Default |
|---|---|---|
PUID |
User ID the container process runs as. Set this to match your host user ID. | 1000 |
PGID |
Group ID the container process runs as. Set this to match your host group ID. | 1000 |
Plugins, themes, engines
| Variable | Description | Default |
|---|---|---|
DEGOOG_PLUGINS_DIR |
Directory to load custom command and slot plugins from | data/plugins |
DEGOOG_THEMES_DIR |
Directory to load custom themes from | data/themes |
DEGOOG_ENGINES_DIR |
Directory to load custom search engine plugins from | data/engines |
DEGOOG_TRANSPORTS_DIR |
Directory to load custom transports from | data/transports |
DEGOOG_PLUGIN_SETTINGS_FILE |
Path to the JSON file storing extension settings (plugins, themes, engines, etc.) | data/plugin-settings.json |
DEGOOG_ALIASES_FILE |
Path to the JSON file defining custom bang command aliases | data/aliases.json |