SuperAdmin User Creation

Create the initial SuperAdmin account for Jitera Self-Hosted

The SuperAdmin is the highest-privilege role in Jitera. It is required for creating organizations, managing AI model availability, and accessing the administration console. After deployment, you must create at least one SuperAdmin user before the platform can be used.

---

Creating a SuperAdmin

Use the Rake task to assign the SuperAdmin role to a user. The task can promote an existing user or create a new one.

Promote an Existing User

If the user already has an account in Jitera:

kubectl exec -it deploy/jitera-automation-rails -n jitera -- \
  bundle exec rake user:set_super_admin[[e-mail]]

Create a New SuperAdmin User

If the user does not yet have an account:

kubectl exec -it deploy/jitera-automation-rails -n jitera -- \
  bundle exec rake "user:set_super_admin[[e-mail],FirstName,LastName]"

Parameters:

• [e-mail] — the user’s email address (required)
• FirstName — first name (required only for new users)
• LastName — last name (required only for new users)

When a new user is created, a password reset email is sent automatically. Ensure your SMTP configuration is working before running this command.

---

What the Task Does

Scenario	Behavior
User exists	Promotes the existing user to SuperAdmin
User does not exist	Creates a new user with the given name, then promotes to SuperAdmin
Password	A password reset email is sent automatically so the user can set their password

---

Verification

After running the task:

1. Log in to Jitera at https://app.yourdomain.com with the SuperAdmin email
2. Verify that the administration menu is accessible
3. If the user was newly created, check for the password reset email

---

Troubleshooting

Task Fails with Permission Error

Ensure the RAILS_ENV environment variable is set correctly:

kubectl exec -it deploy/jitera-automation-rails -n jitera -- env | grep RAILS_ENV
# Expected: RAILS_ENV=production

Password Reset Email Not Received

1. Check SMTP configuration: kubectl exec -it deploy/jitera-automation-rails -n jitera -- env | grep -i smtp
2. Check email logs: kubectl logs deploy/jitera-automation-rails -n jitera | grep -i mail
3. Verify the email address is correct

---

Next Steps

After creating the SuperAdmin user:

1. Register AI models in the SuperAdmin console
2. Create an organization and invite the initial owner