Configuration

The settings registry (internal/config/settings.go) lists the environment settings this binary reads, their defaults, allowed values and area. The single reference is Advanced settings; its tables are generated from the registry, with behavior notes and recipes beside them.

List the settings supported by your binary:

simple-host settings
simple-host settings --json

Start here

The registry marks DB_DSN and ADMIN_API_KEY as required; the installer supplies them. Its basic settings are SITE_DOMAIN (without it the server starts in setup mode), GOOGLE_OAUTH_CLIENT_ID and GOOGLE_OAUTH_CLIENT_SECRET for Google sign-in, and RESEND_API_KEY and MAIL_FROM for email. Choose the sign-in methods your install needs; see the linked areas for details.

For migration ownership, required settings and rollback, see Deployment profiles.

Settings by area

• Server and addresses
• Accounts and sign-in
• Sites and versions
• Saved data
• Domains and certificates
• Hosted events
• Cleanup and retention
• Email
• Storage and backups
• Observability

See also Rate limits for the format and all rate limiters, and Operational times and limits for startup validation, promised dates and served documentation.

Password accounts: PASSWORD_SIGNIN=on enables username/password sign-in; the binary default is off. PASSWORD_SELF_SIGNUP=on (default) permits public account creation; off leaves creation to the admin. EMAIL_SIGNIN=off accepts either company sign-in or password sign-in as the alternative. See accounts and sign-in.