User Management

About

Create accounts, reset passwords, and manage roles. The email-based sign-up flow needs Mailgun; without it, the Django shell is the fastest path to a first user.

Create your first user

With Mailgun (recommended)

Set these in .env and restart the backend:

MAILGUN_API_KEY=key-...
MAILGUN_SENDER_DOMAIN=mail.yourcompany.com
DEFAULT_FROM_EMAIL=no-reply@yourcompany.com

docker compose restart backend

Then sign up via http://localhost:3000.

Without Mailgun — Django shell

docker compose exec backend python manage.py shell -c "
from django.contrib.auth.hashers import make_password
from accounts.models import User
User.objects.create(email='you@example.com', password=make_password('your-password'))
"

Log in at http://localhost:3000 with those credentials.

Superuser

docker compose exec backend python manage.py createsuperuser

Superusers can access the Django admin at http://localhost:8000/admin/.

Reset a password

docker compose exec backend python manage.py shell -c "
from django.contrib.auth.hashers import make_password
from accounts.models import User
u = User.objects.get(email='you@example.com')
u.password = make_password('new-password')
u.save()
"

Roles and permissions

Manage workspace roles and permissions in the platform UI under Settings → User Management and Settings → Roles & Permissions. See Roles & Permissions for the full model.

SSO / SAML2

Future AGI includes a saml2_auth module for SAML2 SSO (Okta, Azure AD, Google Workspace). Configuration requires a SAML2 metadata file and environment variables mounted into the backend container. For setup details, open a discussion at github.com/future-agi/future-agi.

Next Steps