documentation
04 admin

Admin overview

The admin section is for the people running an Exolvra instance — installing it, managing users, handling approvals, and keeping it healthy. Start here, then pick the page that matches what you're trying to do.

Who this section is for

If you’re the person responsible for a deployed Exolvra instance — setting it up, inviting users, configuring providers, granting access, reviewing audit logs, handling approval requests — this is your section. It’s written for admins, not end-users.

Dashboard end-users who chat with agents, run projects, and use the tools can skip straight to Concepts and Dashboard.

What’s in here

  • Users and teams — create users, assign roles, organise them into teams. Covers the role hierarchy and the boundaries between teams.
  • Licensing — activate a license key, read your tier, and upgrade. Covers tier features and renewals.
  • Audit log — search every significant action across the instance. Covers filters, export, and retention.
  • Approvals — review approval requests that agents raise before running gated actions. Covers the inbox, decision flow, and configuring which actions need approval.
  • Security and cloud mode — harden your deployment. Covers the capability model, cloud mode for multi-tenant deployments, and session-scoped permissions.

The five-minute admin checklist

If you just stood up a new Exolvra instance, here’s what to do first:

  1. Log in with the bootstrap credentials printed to the console on first run, and immediately change the admin password from Profile → Security.
  2. Configure at least one LLM provider from Config → AI Providers. Paste your API key and save — agents need a provider to run.
  3. Set a daily budget from Config → Budget & Security so a mistake can’t burn through your billing.
  4. Review cloud mode under Config → Budget & Security. If you’re hosting Exolvra for multiple people who don’t fully trust each other, turn it on.
  5. Create your second user from the admin users page and pick the right role for them.
  6. Test an agent in the dashboard by opening Chat and sending a message. Verify tool calls stream and cost lands in the budget page.

Once those six steps work, you’re live.

  • Getting started → Installation for the install and first-run process
  • Integrations → MCP setup if you plan to use community MCP servers
  • Integrations → Channels to connect Exolvra to Telegram, Discord, or Slack
  • API reference → Authentication if you’re building external integrations against a chatbot API key