Degoog Environment variables
Configure your port, paths, and optional settings.
General
| Variable | Description | Default |
|---|---|---|
DEGOOG_PORT |
The port your server listens on. | 4444 |
DEGOOG_SETTINGS_PASSWORDS |
A comma separated list of passwords for your Settings page. If you set this, users must enter one of these passwords to access your settings (unless you are using a middleware plugin as a gate). | |
DEGOOG_PUBLIC_INSTANCE |
Set this to a truthy value (like true or
1) to run your instance in read only mode.
Settings will only show theme and engine toggles without any
tabs, and all server side mutation APIs will return
Unauthorized.
|
|
DEGOOG_DISTRUST_PROXY |
Set this to a truthy value to ignore
X-Forwarded-For and
X-Real-IP headers for rate limiting. You should
use this if Degoog is exposed directly to the internet without
a reverse proxy so clients cannot spoof their IP address.
|
|
DEGOOG_DEFAULT_SEARCH_LANGUAGE |
The default ISO 639 1 language code applied to all searches
when a user does not select a specific language (like
en, de, or it).
|
en-US |
DEGOOG_I18N |
This forces the UI locale for all requests and overrides the
Accept-Language header (for example
en-US or fr-FR). When you set this,
the normal locale pipeline runs but uses this as the source.
If left empty, it falls back to the
Accept-Language header.
|
|
LOG_LEVEL |
Controls how verbose your server console output is. Supported
levels from most to least severe are fatal,
error, warn, info,
log, and debug. Each level includes
all messages of higher severity. Use debug to
print absolutely everything, including your plugin execution
times. If you use Docker, you can view your logs by running
docker compose logs -f.
|
info |
Docker
| Variable | Description | Default |
|---|---|---|
PUID |
The user ID your container process runs as. You should set this to match your host user ID. | 1000 |
PGID |
The group ID your container process runs as. You should set this to match your host group ID. | 1000 |
Plugins, themes, engines
| Variable | Description | Default |
|---|---|---|
DEGOOG_PLUGINS_DIR |
The directory where you load custom command and slot plugins. | data/plugins |
DEGOOG_THEMES_DIR |
The directory where you load custom themes. | data/themes |
DEGOOG_ENGINES_DIR |
The directory where you load custom search engine plugins. | data/engines |
DEGOOG_TRANSPORTS_DIR |
The directory where you load custom transports. | data/transports |
DEGOOG_PLUGIN_SETTINGS_FILE |
The path to the JSON file that stores your extension settings (for plugins, themes, engines, and more). | data/plugin-settings.json |
DEGOOG_ALIASES_FILE |
The path to the JSON file where your custom bang command aliases are defined. | data/aliases.json |