Containers! Containers! Containers!

FusionAuth loves containers, found an issue? Please open a bug or submit a PR.

Credits

• @sims-security Thank you for the proxy-docker section.
• @ssirag Thank you for the feedback and bug reports.
• @minyangu Thank you for PR #3 to enhance our docker-compose example.
• János Veres Thank you for building out an example Kubernetes configuration via PR #6, this will be very valuable to the FusionAuth community.
• @trollr and the Ninjaneers team for the helm configuration and all of their contribution.
• @vladyslav2 for PR #15 to make the Docker Compose example work better when invoked via bash.
• @drpebcak for all of your contribution and assistance in this repo!
• @sims-security for the proxy examples in proxy-docker/!
• The FusionAuth team - couldn't have done it without you!

Contributors

• @nadilas
• @trollr
• @drpebcak
• @sims-security

https://github.com/fusionauth/fusionauth-contrib is the new repository for all contributions, including container runtimes and configs.

Review us on G2

https://www.g2.com/products/fusionauth/take_survey

Docker

Docker Compose

The reference docker-compose.yml defaults to use opensearch as the search engine.

Review our Docker Install Guide for additional assistance.

curl -o docker-compose.yml https://raw.githubusercontent.com/FusionAuth/fusionauth-containers/master/docker/fusionauth/docker-compose.yml
curl -o .env https://raw.githubusercontent.com/FusionAuth/fusionauth-containers/master/docker/fusionauth/.env
docker compose up

This compose file includes a number of profiles that you can use to enable various optional services. The profiles are:

• caddy - This profile enables a Caddy service that is configured to proxy to FusionAuth on ports 80 and 443.
• mailcatcher - This profile enables Mailcatcher, which is a test SMTP server. You can configure FusionAuth to use this SMTP server during development and testing.
• kafka - This profile enables Kafka (and Zookeeper) which you can use Kafka to receive Webhook events.
• cleanspeak - This profile enables Cleanspeak, which you can use to filter usernames and profile data for profanity and other unwanted content.

To enable a profile, you use the --profile switch on the command-line like this (use can use multiple instances of this switch to enable multiple profiles):

docker compose --profile caddy --profile kafka up

Docker Images

Docker images are available on Docker Hub

FusionAuth App

docker pull fusionauth/fusionauth-app:latest

Kubernetes

Kubernetes is a supported platform. The supported installation method is Helm.

Review our Kubernetes Install Guide for additional assistance.

The FusionAuth Helm chart is managed in a separate repository. See README for more information.

OpenShift

Please see https://github.com/fusionauth/fusionauth-contrib for openshift information.

Helm

Please see https://fusionauth.io/docs/v1/tech/installation-guide/kubernetes/

Proxy-Docker

Please see https://github.com/fusionauth/fusionauth-contrib for proxy-docker information.