Skip to content
Hydra

Configuration

Hydra reads its settings from environment variables in its service file (on Ubuntu, /etc/hydra/hydra.env, readable only by root and the service). Change a value, then restart the service. Everything else (people, roles, models, integrations) is set in the app and stored on the server.

Sign-in and people

Setting What it decides
HYDRA_AUTH Sign-in methods, a comma list. google for a team server. demo makes a read-only demo: visitors pick an invented person and nothing can be written; use it alone, never beside another method. Hydra refuses to start on an unknown value.
HYDRA_OWNER_EMAILS Addresses that become owner at their first sign-in. Keep it to one or two people.
HYDRA_PREAPPROVED_DOMAINS Email domains whose people start active as members. Others wait for an admin.
HYDRA_COMPANY_WORKSPACE id:Name of the company workspace that every pre-approved person joins.
HYDRA_UI_LANG_EN Addresses that see the screens in English by default. Everyone else starts in Vietnamese; each person can change it in Settings.

Where data lives

Setting What it holds
HYDRA_STATE_DIR People, sessions, the audit log and the server's own secret. Back this up.
HYDRA_DATA_DIR The project registry, ports and server settings.
HYDRA_BLOB_DIR Uploaded files and generated pictures (defaults to blobs/ inside the state directory).
HYDRA_WORKSPACES_DIR One folder per workspace, holding its skills and shared files.

All four are plain folders on your disk. A backup of them is a backup of Hydra.

Network

Setting What it decides
HYDRA_PUBLIC_ORIGIN The address people use, such as https://hydra.example.com. Links in emails use it.
HYDRA_PORT The port Hydra listens on.
HYDRA_TLS 0 when your reverse proxy terminates TLS and Hydra should serve plain HTTP behind it.

Work done on the server

Setting What it decides
HYDRA_LOCAL_HEAVY off keeps OCR, speech and other heavy tools off this server; they run through remote drivers instead. Leave it off on a small server.
HYDRA_MONITOR off stops the disk and health sampler (and its alerts). Leave it on for a real server; turn it off for a demo or a test copy.

After a change, check the server answers: curl -fsS https://<your address>/login returns the sign-in page.