Users & Permissions Overview
Codex includes a comprehensive user management system with fine-grained permissions. This guide covers user creation, permission management, and API keys.
Quick Start
Create Admin User
# Via CLI during setup
codex seed --config codex.yaml
Add Users
- Go to Settings > Users
- Click Add User
- Set username, email, password
- Select permissions
- Save
Create API Key
- Go to Profile > API Keys
- Click Create API Key
- Name the key and select permissions
- Copy the key (shown only once!)
Core Concepts
User Types
| Type | Access | Use Case |
|---|---|---|
| Admin | Full system access | Server administrators |
| User | Permission-based | Regular readers |
| API Key | Permission-based | Automation, scripts |
Authentication Methods
| Method | Use Case | Example |
|---|---|---|
| JWT Token | Web UI, API clients | Authorization: Bearer token |
| API Key | Automation, services | Authorization: Bearer codex_key |
| Basic Auth | Simple clients, OPDS | curl -u user:pass |
In This Section
- User Management - Creating and managing user accounts
- Permissions - Understanding the permission system
- API Keys - Creating and managing API keys
- Authentication - Login methods and security