https://github.com/fusionauth/fusionauth-example-docker-compose
Examples of using FusionAuth with docker compose
https://github.com/fusionauth/fusionauth-example-docker-compose
compose docker fusionauth
Last synced: 4 months ago
JSON representation
Examples of using FusionAuth with docker compose
- Host: GitHub
- URL: https://github.com/fusionauth/fusionauth-example-docker-compose
- Owner: FusionAuth
- License: other
- Created: 2024-01-03T18:51:20.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-02-06T22:46:11.000Z (4 months ago)
- Last Synced: 2026-02-07T09:41:16.896Z (4 months ago)
- Topics: compose, docker, fusionauth
- Language: FreeMarker
- Homepage: https://fusionauth.io
- Size: 37.1 KB
- Stars: 6
- Watchers: 8
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Example Docker Compose Configurations
This repository contains different FusionAuth docker compose configuration examples used in the [Using FusionAuth on Docker](https://fusionauth.io/docs/get-started/download-and-install/docker) documentation.
## Contents
There are multiple examples, one directory for each.
### build
An example which builds Example Password Hasher Plugin and adds it in to a custom fusionauth-app image.
### kickstart
A complex example using kickstart to stage a development FusionAuth environment.
### light
A lightweight Docker compose configuration used in guides to quickly spin up FusionAuth locally with configurations from a kickstart for demonstration with no need for OpenSearch.
### mailcatcher
An example which stages a development FusionAuth environment including mailcatcher which allows FusionAuth to send transactional emails for account verification, password reset, and others in your development environment.
### plugin
An example which builds an Example Password Hasher Plugin with a maven init-container and adds it in to a mounted directory. Which then, when built successfully, gets directly mounted as a directory in to your FusionAuth Docker container.
## Dependencies
* Docker, for running FusionAuth and related services.
## Running FusionAuth examples
To run FusionAuth, just change in to one of the example directories and stand up the docker containers using `docker compose`.
```shell
docker compose up -d
```
This will start the FusionAuth example with the related services.
To fully remove the example you have to remove the volumes too by running the following command inside the according example directory
```shell
docker compose down -v
```