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

Ziel

4444

Standard

4444

Wert

4444

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

Ziel

/app/data

Wert

/mnt/user/appdata/degoog/data

Process User ID that the container will run as.

Standard

99

Wert

99

Process Group ID that the container will run as.

Standard

100

Wert

100

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

Ziel

DEGOOG_PORT

Standard

4444

Wert

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

Ziel

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.

Ziel

LOG_LEVEL

Standard

info|fatal|error|warn|log|debug

Wert

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.

Ziel

LOG_TRANSLATION

Standard

false|true

Wert

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

Ziel

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.

Ziel

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.

Ziel

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.

Ziel

DEGOOG_DISTRUST_PROXY

Standard

1|0

Wert

1

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

Ziel

DEGOOG_DEFAULT_SEARCH_LANGUAGE

Standard

en-US

Wert

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.

Ziel

DEGOOG_I18N

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

Ziel

DEGOOG_PLUGINS_DIR

Standard

data/plugins

Optional. Directory to load custom themes from.

Ziel

DEGOOG_THEMES_DIR

Standard

data/themes

Optional. Directory to load custom search engine plugins from.

Ziel

DEGOOG_ENGINES_DIR

Standard

data/engines

Optional. Directory to load custom transports from.

Ziel

DEGOOG_TRANSPORTS_DIR

Standard

data/transports

Optional. Directory to load custom autocomplete from.

Ziel

DEGOOG_AUTOCOMPLETE_DIR

Standard

data/autocomplete

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

Ziel

DEGOOG_PLUGIN_SETTINGS_FILE

Standard

data/plugin-settings.json

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

Ziel

DEGOOG_DEFAULT_ENGINES_FILE

Standard

data/default-engines.json

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

Ziel

DEGOOG_BLOCKLIST_FILE

Standard

data/blocklist.json

Optional. Path to the JSON file storing settings tokens.

Ziel

DEGOOG_SETTINGS_TOKENS_FILE

Standard

data/settings-tokens.json

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

Ziel

DEGOOG_ALIASES_FILE

Standard

data/aliases.json