---
title: Charmhub | Deploy Authentik Server Operator using Charmhub - The Open Operator
  Collection
description: Deploy the latest version of Authentik Server Operator as a Kubernetes
  Operator on any cloud. Operator for Authentik Server
url: https://charmhub.io/authentik-server
---

# Authentik Server Operator

[prod-identity-charmhub-bot-2](https://charmhub.io/publisher/prod-identity-charmhub-bot-2 "View all packages from prod-identity-charmhub-bot-2")

* [prod-identity-charmhub-bot-2](https://charmhub.io/publisher/prod-identity-charmhub-bot-2 "View all packages from prod-identity-charmhub-bot-2")

Platform:

stable 31

```
juju deploy authentik-server
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

[Read documentation](https://charmhub.io/authentik-server)

#### Contacts

* [Submit a bug](https://github.com/canonical/authentik-server-operator/issues)

---

Share your thoughts on this charm with the community on discourse.

[Join the discussion](https://discourse.charmhub.io/)

#### Operator for Authentik Server

# Charmed Authentik Server

## Description

Charmed Authentik Server is an open-source, highly versatile Identity Provider focused on flexibility and integration. It provides unified authentication, user management, and authorization out-of-the-box, supporting industry-standard protocols such as OAuth2, OpenID Connect, SAML, and LDAP.

This operator manages the core Authentik Server application on Kubernetes, handling its deployment, configuration, scaling, and integration with required and optional dependencies in a declarative, automated manner using Juju.

## Usage & Deployment

### Basic Deployment

Authentik Server requires a PostgreSQL database to store its application state and a related Authentik Worker to handle background tasks (such as emails, task synchronization, and outposts).

To deploy a basic, fully functioning Authentik instance:

```
# Deploy the PostgreSQL database operator
juju deploy postgresql-k8s --channel 14/stable --trust

# Deploy the Authentik Server (this charm)
juju deploy authentik-server --channel latest/stable --trust

# Deploy the Authentik Worker operator
juju deploy authentik-worker --channel latest/stable --trust

# Integrate Authentik Server with the PostgreSQL database
juju integrate postgresql-k8s authentik-server

# Integrate Authentik Server with the Authentik Worker
juju integrate authentik-server:authentik-cluster authentik-worker:authentik-cluster
```

You can track the deployment status using:

```
watch -c juju status --color
```

Once the charms settle into an `active` and `idle` status, the Authentik Server is ready to use.

### Terraform Deployment

For environments where infrastructure-as-code is preferred, a production-ready set of Terraform modules (Core, Solution stack, and runnable Tutorial scenarios) are available.

To learn how to provision the complete Authentik stack with a single command, please see the [Charmed Authentik Terraform Guide](https://charmhub.io/terraform/README.md).

### Documentation

Please see our comprehensive documentation guides located in the [docs/](https://charmhub.io/docs/) folder:

* **Tutorials**: [Getting Started with Charmed Authentik](https://charmhub.io/docs/tutorials/getting-started.md)
* **How-To Guides**:
  + [How to Bootstrap Charmed Authentik](https://charmhub.io/docs/how-to/bootstrap-authentik.md)
  + [How to Protect OIDC/OAuth Applications](https://charmhub.io/docs/how-to/protect-oidc-oauth-applications.md)
  + [How to Protect LDAP Applications](https://charmhub.io/docs/how-to/protect-ldap-applications.md)
  + [How to Integrate Upstream Identity Providers](https://charmhub.io/docs/how-to/integrate-upstream-provider.md)
  + [How to Manage Users and Groups](https://charmhub.io/docs/how-to/manage-users-and-groups.md)
  + [Common Operational Administration Tasks](https://charmhub.io/docs/how-to/common-admin-tasks.md)
* **Reference**: [Charmed Authentik Configuration Reference](https://charmhub.io/docs/reference/configurations.md)
* **Explanation**: [Charmed Authentik Architecture & Security Design](https://charmhub.io/docs/explanation/architecture.md)

## Integrations

### PostgreSQL (`pg-database`)

An integration with [postgresql-k8s-operator](https://github.com/canonical/postgresql-k8s-operator) is **required**. The Authentik Server stores all configuration, users, and session data in this database.

### Authentik Worker (`authentik-cluster`)

An integration with [authentik-worker-operator](https://github.com/canonical/authentik-worker-operator) is **required**. The Authentik Worker handles background processes, outposts, and other asynchronous tasks for the cluster.

### Ingress (`traefik-route`)

An integration with [traefik-k8s-operator](https://github.com/canonical/traefik-k8s-operator) is **required**. The Authentik Server utilizes the `traefik_route` interface to define precise ingress routing and SSL termination:

```
juju integrate traefik-k8s authentik-server:traefik-route
```

### Observability

Charmed Authentik Server offers seamless integration with the Canonical Observability Stack (COS) to forward logs, expose metrics, and export traces:

* **Logging** (`logging`): Forward workload logs to Loki.

  ```
  juju integrate loki-k8s authentik-server:logging
  ```
* **Metrics** (`metrics-endpoint`): Expose Prometheus scrape endpoints.

  ```
  juju integrate prometheus-k8s authentik-server:metrics-endpoint
  ```
* **Dashboards** (`grafana-dashboard`): Import built-in Grafana monitoring dashboards.

  ```
  juju integrate grafana-k8s authentik-server:grafana-dashboard
  ```
* **Tracing** (`tracing`): Send application trace data to Tempo.

  ```
  juju integrate tempo-k8s authentik-server:tracing
  ```

## Scenarios

### Retrieving Bootstrap Credentials

On the first start, Charmed Authentik Server automatically generates secure bootstrap credentials for the default administrator account, **`akadmin`**.

To retrieve the generated password and token, run the `get-bootstrap-admin-credentials` action on the leader unit:

```
juju run authentik-server/leader get-bootstrap-admin-credentials
```

The output will contain:

* `username`: The default administrator user (`akadmin`).
* `password`: The generated secure administrator password.
* `bootstrap-token`: The initial API bootstrap token.

## Security

Please see [SECURITY.md](https://github.com/canonical/authentik-server-operator/blob/main/SECURITY.md) for guidelines on reporting security issues.

## Contributing

Please see the [Juju SDK docs](https://juju.is/docs/sdk) for guidelines on enhancements to this charm following best practice guidelines, and [CONTRIBUTING.md](https://github.com/canonical/authentik-server-operator/blob/main/CONTRIBUTING.md) for developer guidance.

## License

The Charmed Authentik Server is free software, distributed under the Apache Software License, version 2.0. See [LICENSE](https://github.com/canonical/authentik-server-operator/blob/main/LICENSE) for more information.
