Nelsar.Axia documentation
Nelsar.Axia is a self-hosted web console and REST API for managing Active Directory, OpenLDAP and other LDAP directories: users, groups, organizational units and computer accounts, with roles mapped from directory groups, an audit log and bulk provisioning.
The README is the short version. This folder is the long one: every feature, every setting, and the details that only matter once you run it against a real directory.
Start here
| If you want to… | Read |
|---|---|
| See it working in five minutes | Installation → Quick start |
| Run it from source against your own directory | Installation → From source |
| Develop against a realistic directory on your machine | Local test directory |
| Put it in front of real users | Production deployment |
Reference
| Page | What it covers |
|---|---|
| Overview | What the application is made of and the concepts the rest of the documentation uses: directories, sessions, roles, permissions, entry ids. |
| Installation | Requirements and dependencies, and the three ways to get a running instance. |
| Local test directory | The development OpenLDAP in deploy/dev: an AD-shaped domain with ~1,500 accounts, ~2,000 computers and ~110 groups. |
| Production deployment | Container image, secrets, reverse proxy and TLS, the bind account, persistence, upgrades, a checklist. |
| Configuration reference | Every setting, its default, and what the API refuses to start with. |
| Directories | Active Directory and OpenLDAP, connection security, several directories at once, failover, what is read and what is written. |
| Access control | Roles, the permission catalogue, role mappings, protected accounts and groups. |
| Features | Users, bulk operations, the login generator, groups, organizational units, computers, audit log, rate limits, the console. |
| REST API | Conventions — authentication, headers, paging, errors — and every endpoint. |
| Operations | Logging and log shipping, the database and migrations, caches, backups. |
| Troubleshooting | Startup refusals, sign-in failures and odd listings, with their causes. |
| Development | Architecture, building, testing, and the conventions the tests enforce. |
Elsewhere in the repository
- SECURITY.md — the trust model, known limitations, and how to report a vulnerability. Read the known limitations before deploying.
- CONTRIBUTING.md — how to run what CI runs, and the conventions a pull request is held to.
- ROADMAP.md — what is planned, and what is not done yet.
- frontend/README.md — the console’s own structure.