Frontend-only development environment
If you want to only make changes on the UI, you don't need a backend running from source. You can user the docker-compose install with a few customizations.
- Node.js (any recent version should work; we use 20.x to build)
- Make (again, any recent version should work)
- Docker and Docker Compose
Depending on platform, some native dependencies might be required. On macOS, run
brew install node@20, and for Docker
brew install --cask docker
Clone the git repo from https://github.com/goauthentik/authentik
In the cloned repository, follow the docker-compose installation instructions here
Add the following entry to your
This will cause authentik to use the beta images.
Add this volume mapping to your compose file
This makes the local web files and the config file available to the authentik server.
docker-compose up -dto apply those changes to your containers.
npm iand then
npm run watchto start the build process.
You can now access authentik on http://localhost:9000 (or https://localhost:9443).
You might also want to complete the initial setup under