​
Prerequisites

Before creating a superuser, ensure that:
  1. All services are running: 
    docker compose ps
  2. The database is properly initialized: 
    docker compose logs db

​
Creating the Superuser

​
Using the Command Line

Run the following command to create a superuser: 
docker compose exec camel python manage.py createuser
You’ll be prompted to enter:
  • Username
  • Email address
  • Password (and confirmation)
Example interaction: 
Username: admin
Email address: [email protected]
Password: ********
Password (again): ********

​
Password Requirements

The password should meet the following requirements:
  • At least 8 characters long
  • Not too common
  • Not entirely numeric
  • Not similar to your username
  • Not a commonly used password

​
Verifying the Superuser

​
Check User Creation

You can verify the superuser was created by checking the database: 
docker compose exec db psql -U camel -d camel -c "SELECT username, email, is_superuser FROM auth_user;"

​
Test Login

  1. Visit the admin interface: 
    http://localhost:8000/admin/
  2. Log in with your superuser credentials

​
Troubleshooting

​
Common Issues

  1. Database Connection Error
    • Check if the database service is running
    • Verify environment variables are correct
    • Check database logs: 
      docker compose logs db
  2. Permission Issues
    • Ensure you have the correct permissions: 
      sudo chown -R $USER:$USER .
  3. User Creation Fails
    • Check application logs: 
      docker compose logs camel

​
Resetting Password

If you need to reset the superuser password: 
docker compose exec camel python manage.py changepassword admin

​
Next Steps

After creating your superuser account:
  1. Log in to camelAI
  2. Configure Initial Settings