# Guardian

Token-based authentication library for Elixir applications, with JSON Web Tokens by default and Plug integration.


Source: https://findsoftware.frbit.cloud/guardian-elixir/
Last reviewed: 2026-11-09
Listed since: 2026-11-09

## Record

### Links

- repository: https://github.com/ueberauth/guardian
- docs: https://hexdocs.pm/guardian

### Identity

- status: active
- maintainer: Daniel Neighman
- maintainerType: unknown
- parent: unknown
- firstRelease: 2015
- hqCountry: unknown

### Kind

- category: auth
- hosting: elixir
- language: elixir
- runtime: beam
- runtimeMin: unknown
- basedOn: unknown

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: unknown
- renderingModes: not applicable
- installMethod: mix

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 2
- latestReleaseDate: 2026-08-17

### Adoption

- githubStargazers: 3513
- packagistDownloads: not applicable
- npmWeeklyDownloads: not applicable
- contributors: 160
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 1685
- dependentPackages: 31

### Sources

- urls: https://api.github.com/repos/ueberauth/guardian (read 2026-11-09)
- urls: https://raw.githubusercontent.com/ueberauth/guardian/master/README.md (read 2026-11-09)
- firstRelease: https://api.github.com/repos/ueberauth/guardian/tags (read 2026-11-09)
- maintainer: https://raw.githubusercontent.com/ueberauth/guardian/master/LICENSE (read 2026-11-09)
- category: https://raw.githubusercontent.com/ueberauth/guardian/master/README.md (read 2026-11-09)
- language: https://api.github.com/repos/ueberauth/guardian (read 2026-11-09)
- runtime: https://raw.githubusercontent.com/ueberauth/guardian/master/README.md (read 2026-11-09)
- installMethod: https://raw.githubusercontent.com/ueberauth/guardian/master/README.md (read 2026-11-09)
- license: https://raw.githubusercontent.com/ueberauth/guardian/master/README.md (read 2026-11-09)
- licenseModel: https://raw.githubusercontent.com/ueberauth/guardian/master/LICENSE (read 2026-11-09)
- currentMajor: https://api.github.com/repos/ueberauth/guardian/releases (read 2026-11-09)
- latestReleaseDate: https://api.github.com/repos/ueberauth/guardian/releases (read 2026-11-09)
- githubStargazers: https://api.github.com/repos/ueberauth/guardian (read 2026-11-09)
- contributors: https://api.github.com/repos/ueberauth/guardian/contributors?per_page=1 (read 2026-11-09)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/hex.pm/packages/guardian (read 2026-11-09)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/hex.pm/packages/guardian (read 2026-11-09)

## Notes

Guardian is a token-based authentication library for Elixir applications. Its core functions encode and sign a token for a resource, decode and verify it, revoke it and refresh it, with JSON Web Tokens as the default token type. It integrates with Plug and can be used outside it.

## Worth knowing

Revoking a JWT token does nothing by default, because the application does not track the tokens it issues. The README points to [GuardianDb](https://github.com/ueberauth/guardian_db) for recording issued tokens so that revocation takes effect.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0