You can change 4444 to any available port on your host system. Must match DEGOOG_PORT.

Target

4444

Default

4444

Value

4444

Holds plugins, themes, engines, transports, plugin settings and aliases.

Target

/app/data

Value

/mnt/user/appdata/degoog/data

Process User ID that the container will run as.

Default

99

Value

99

Process Group ID that the container will run as.

Default

100

Value

100

Port the server listens on inside the container. Must match the host port mapping above.

Target

DEGOOG_PORT

Default

4444

Value

4444

Optional. Base path for serving Degoog behind a reverse proxy at a sub-path (e.g. /degoog). A full URL is also accepted — only the path portion is used. Leave empty to serve at the root /.

Target

DEGOOG_BASE_URL

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.

Target

LOG_LEVEL

Default

info|fatal|error|warn|log|debug

Value

info

Optional. Set to true to enable translation-specific log output. This is a separate toggle from LOG_LEVEL and is off by default. Useful when debugging missing keys, locale resolution misses, or broken locale files.

Target

LOG_TRANSLATION

Default

false|true

Value

false

Optional. 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).

Target

DEGOOG_SETTINGS_PASSWORDS

Optional. Custom path for the admin settings panel. Defaults to /admin on public instances and /settings on private ones. Set to a hard-to-guess string to make the panel undiscoverable (e.g. my-secret-panel-abc123). Leading slashes are stripped automatically. Note: on public instances this path only works if DEGOOG_SETTINGS_PASSWORDS is also set.

Target

DEGOOG_SETTINGS_PATH

Optional. 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.

Target

DEGOOG_PUBLIC_INSTANCE

Optional. Controls whether Degoog trusts X-Forwarded-For, X-Real-IP and X-Forwarded-Proto headers for client IP, rate limiting, IP banning and HTTPS detection. Defaults to 1 (distrust), which is the safe choice when Degoog is exposed directly to the internet, since trusting these headers lets any client spoof their source IP and protocol. Set to 0 only when Degoog sits behind a reverse proxy (nginx, caddy, traefik, etc.) that you control and that strips or rewrites these headers on incoming requests.

Target

DEGOOG_DISTRUST_PROXY

Default

1|0

Value

1

Default ISO 639-1 language code applied to all searches when no language is selected by the user (e.g. en, de, it).

Target

DEGOOG_DEFAULT_SEARCH_LANGUAGE

Default

en-US

Value

en-US

Optional. Forces the UI locale for all requests, overriding the Accept-Language header (e.g. en-US, fr-FR). Unset or empty: Accept-Language is used.

Target

DEGOOG_I18N

Optional. Directory to load custom command and slot plugins from.

Target

DEGOOG_PLUGINS_DIR

Default

data/plugins

Optional. Directory to load custom themes from.

Target

DEGOOG_THEMES_DIR

Default

data/themes

Optional. Directory to load custom search engine plugins from.

Target

DEGOOG_ENGINES_DIR

Default

data/engines

Optional. Directory to load custom transports from.

Target

DEGOOG_TRANSPORTS_DIR

Default

data/transports

Optional. Directory to load custom autocomplete from.

Target

DEGOOG_AUTOCOMPLETE_DIR

Default

data/autocomplete

Optional. Path to the JSON file storing extension settings (plugins, themes, engines, etc.).

Target

DEGOOG_PLUGIN_SETTINGS_FILE

Default

data/plugin-settings.json

Optional. Path to the JSON file storing default enabled/disabled engines.

Target

DEGOOG_DEFAULT_ENGINES_FILE

Default

data/default-engines.json

Optional. Path to the JSON file storing the IP addresses blocklist.

Target

DEGOOG_BLOCKLIST_FILE

Default

data/blocklist.json

Optional. Path to the JSON file storing settings tokens.

Target

DEGOOG_SETTINGS_TOKENS_FILE

Default

data/settings-tokens.json

Optional. Path to the JSON file defining custom bang command aliases.

Target

DEGOOG_ALIASES_FILE

Default

data/aliases.json