eliott/authentik
1
0
Fork 0
mirror of https://github.com/goauthentik/authentik synced 2026-04-26 01:25:02 +02:00
Code Issues Packages Projects Releases Wiki Activity

web: Docker versioning compatibility (#16139)

Browse Source 
* website/docs: update frontend dev docs to always use latest dev images

Signed-off-by: Marc 'risson' Schmitt <marc.schmitt@risson.space>

* website: Clarify instructions.

---------

Signed-off-by: Marc 'risson' Schmitt <marc.schmitt@risson.space>
Co-authored-by: Teffen Ellis <teffen@goauthentik.io>
This commit is contained in:
Marc 'risson' Schmitt
2025-08-26 21:12:20 +00:00
committed by GitHub
parent 2a7d61c6aa
commit 30d3a0cdc3
1 changed files with 8 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
website/docs/developer-docs/setup/frontend-dev-environment.md
View File

@@ -32,22 +32,19 @@ Depending on platform, some native dependencies might be required. On macOS, run
cd authentik
```
:::info Beta images
By default, authentik will use the latest stable Docker images.
You can opt into using beta images during development by creating a `.env` file in the root of the repository with the following variables:
2. From the cloned repository, follow the Docker Compose [installation instructions](../../install-config/install/docker-compose.mdx).
3. Create a `.env` file in the root of the repository to configure the Docker Compose environment.
```shell
AUTHENTIK_IMAGE=ghcr.io/goauthentik/dev-server
AUTHENTIK_TAG=gh-next
AUTHENTIK_OUTPOSTS__CONTAINER_IMAGE_BASE=ghcr.io/goauthentik/dev-%(type)s:gh-next
AUTHENTIK_LOG_LEVEL=debug
GIT_BUILD_HASH="dev"
```
:::
2. From the cloned repository, follow the Docker Compose [installation instructions](../../install-config/install/docker-compose.mdx).
3. Create a Docker Compose override to mount the local configuration file (`local.env.yml`) and ESBuild's output directory (`web`).
4. Create a Docker Compose override to mount the local configuration file (`local.env.yml`) and ESBuild's output directory (`web`).
```yaml title="docker-compose.override.yml"
services:
@@ -59,20 +56,20 @@ Depending on platform, some native dependencies might be required. On macOS, run
By creating this file in the root of the repository, Docker will automatically mount the web files generated by the build process. The `local.env.yml` mount is optional, but allows you to override the default configuration.
4. From the cloned repository root, install the front-end dependencies using NPM.
5. From the cloned repository root, install the front-end dependencies using NPM.
```shell
cd web
npm ci
```
5. From the cloned repository root, run the front-end build script.
6. From the cloned repository root, run the front-end build script.
```shell
make web-watch
```
6. In a new terminal, navigate to the cloned repository root and start the backend containers with Docker Compose.
7. In a new terminal, navigate to the cloned repository root and start the backend containers with Docker Compose.
```shell
docker compose up