Experimental · Labs · v0.1.0

Run Agent of Empires for a whole team.

CityHall is a self-hostable control-plane server for Agent of Empires. Instead of everyone running an isolated local instance, a team runs and coordinates aoe across many machines from one shared backend, with accounts, roles, single sign-on, and invites.

Early and evolving. Expect rough edges, breaking changes, and gaps in the docs. Feedback and contributions welcome.

The control plane

One shared backend for the team

01

User management

Accounts, authentication, email invites, password reset, and a forced password change on first login.

02

Role-based access

Roles built from permission keys, so each teammate gets exactly the access they need and nothing more.

03

Single sign-on

Log in through any OpenID Connect provider your organization already runs.

04

Email / SMTP

Transactional email for invites and verification, wired through your own SMTP server.

05

Optional self-signup

Open registration with email verification when you want hands-off onboarding for a team.

06

One Rust binary

API, web frontend, and CLI ship as a single binary. Bring any SeaORM database: SQLite, Postgres, or MySQL.

Kick the tires

Read the setup guide and the source on GitHub. Open source, MIT licensed.