Skip to main content
Control Panel
The Control Panel is your central hub for administering your self-hosted Rallly instance. From here, you can manage users, activate your license, and configure instance-specific settings. To access the Control Panel:
  1. Ensure your Rallly instance is running.
  2. Open your web browser and navigate to /control-panel.
  3. You may be prompted to log in if you haven’t already. Only users with administrative privileges can access the Control Panel features.

​
Claiming Initial Admin Rights

The first user designated as an administrator needs to manually claim their admin role. This user is specified by the INITIAL_ADMIN_EMAIL environment variable during setup (see Configuration). To claim admin rights:
  1. Ensure the user account associated with the INITIAL_ADMIN_EMAIL has been created (e.g., by logging in once).
  2. Navigate to the Control Panel: /control-panel.
  3. If you are the user specified in INITIAL_ADMIN_EMAIL and have not yet claimed admin rights, you should see a section or button prompting you to “Make me an admin”.
  4. Click this button to elevate your account to an administrator.
Once claimed, this user can manage other users and settings.

​
Troubleshooting

If you see an Administrator access required message when visiting /control-panel, the account you are signed in with does not have the admin role. This usually means:
  • The INITIAL_ADMIN_EMAIL environment variable is not set, or
  • It does not match the email address of the account you are signed in with.
Update INITIAL_ADMIN_EMAIL to match your account’s email address, restart your instance, and visit /control-panel again to claim admin rights. Alternatively, an existing administrator can grant your account the admin role from the Users section of the Control Panel.

​
Update notifications

The Control Panel home page shows the version your instance is running and whether a newer release is available. The check runs against api.rallly.co once an hour and only sends the running version and an anonymous instance identifier. On a restricted network, see Corporate networks. When a release you have not installed yet contains security fixes, every Control Panel page shows a banner linking to the release notes. If your major version has reached end of life and the fix only shipped in a newer major, the banner links to the migration guide instead. Older instances than 4.16 render the plain update notice and cannot tell you about security fixes, so keep an eye on the releases page until you have updated past that version.