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.