Access Control
The Access Control category manages authentication and authorization settings that control how users register and verify their accounts on your Hawkra instance.
Settings Reference
Registration Enabled
| Key | registration_enabled |
| Type | Boolean (toggle) |
| Default | true |
Controls whether new users can create accounts on your instance through the public registration page. When enabled, anyone with access to your Hawkra URL can register a new account (subject to any license-imposed user limits).
Email Verification Enabled
| Key | email_verification_enabled |
| Type | Boolean (toggle) |
| Default | false |
When enabled, newly registered users must verify their email address by entering a 6-character verification code sent to the email they registered with. Until the code is entered, the account is not fully activated.
Prerequisites: SMTP must be configured before enabling this setting. If SMTP is not set up, the verification emails cannot be sent and users will be unable to complete registration.
When disabled:
- Users are activated immediately upon registration without any email verification step.
Enabling email verification without a working SMTP configuration will prevent new users from completing registration. Configure and test your SMTP settings before turning this on.
Configuration via Environment Variables
| Setting | Environment Variable |
|---|---|
| Registration Enabled | REGISTRATION_ENABLED |
| Email Verification Enabled | EMAIL_VERIFICATION_ENABLED |
Remember that your license defines the maximum number of users allowed on the instance. Even with registration enabled, new registrations will be rejected once the user limit is reached. The registration page will display a "Registration Unavailable" message in this case.