Downloads

Docker Compose
Docker Vanilla

Docker Compose

Use the following Docker Compose commands to get up and running quickly with FusionAuth, PostgreSQL, and Opensearch. You might need to modify it if you are using a different operating system. Feel free to open an issue in GitHub if you find any issues.

Step 1: Download the Docker files

Linux/Unix/macOS
Windows

  curl -fsSL https://raw.githubusercontent.com/FusionAuth/fusionauth-containers/main/docker/fusionauth/docker-compose.yml > docker-compose.yml && \
curl -fsSL https://raw.githubusercontent.com/FusionAuth/fusionauth-containers/main/docker/fusionauth/.env > .env

  Invoke-WebRequest -UseBasicParsing https://raw.githubusercontent.com/FusionAuth/fusionauth-containers/main/docker/fusionauth/docker-compose.yml -OutFile docker-compose.yml
Invoke-WebRequest -UseBasicParsing https://raw.githubusercontent.com/FusionAuth/fusionauth-containers/main/docker/fusionauth/.env -OutFile .env

Step 2: Start the Docker Compose containers

  docker compose up

Then open http://localhost:9011 in your browser.

Docker Vanilla

Use the following Docker commands to start just FusionAuth without a database. You'll need to install and configure a database manually. Feel free to open an issue in GitHub if you find any issues.

Step 1: Install FusionAuth Docker container

  docker pull fusionauth/fusionauth-app

Step 2: Start the Docker container

  docker run -it -p 9011:9011 --add-host host.docker.internal:host-gateway fusionauth/fusionauth-app

NOTE: If you are running the database on the host machine, use the hostname `host.docker.internal` to connect FusionAuth to the database rather than `localhost`.

Then open http://localhost:9011 in your browser.

Fast Path

macOS Fast Path

Copy and paste the code below into Terminal/iTerm and we'll do the rest (feel free to read the install scripts first). This installation method installs the FusionAuth ZIP packages into the current working directory. You'll also need to manually install a database for FusionAuth to work. You can learn more about our Fast Path installation in our Fast Path Installation Guide. Feel free to open an issue in GitHub if you find any issues.

Step 1: Download and install the ZIP files

  curl -fsSL https://raw.githubusercontent.com/FusionAuth/fusionauth-install/master/install.sh | bash -s && \
cd fusionauth

Step 2: Start FusionAuth

  bin/startup.sh

Then open http://localhost:9011 in your browser.

Linux Fast Path

Linux Fast Path

Copy and paste the code below and we'll do the rest (feel free to read the install scripts first). This installation method installs the FusionAuth ZIP packages into the current working directory. You'll also need to manually install a database for FusionAuth to work. You can learn more about our Fast Path installation in our Fast Path Installation Guide. Feel free to open an issue in GitHub if you find any issues.

Step 1: Download and install the ZIP files

  curl -fsSL https://raw.githubusercontent.com/FusionAuth/fusionauth-install/master/install.sh | bash -s && \
cd fusionauth

Step 2: Start FusionAuth

  bin/startup.sh

Then open http://localhost:9011 in your browser.

Fast Path
WSL v2

Windows Fast Path

Copy and paste the code below into PowerShell and we'll do the rest (feel free to read the install scripts first). This installation method installs the FusionAuth ZIP packages into the current working directory. You'll also need to manually install a database for FusionAuth to work. You can learn more about our Fast Path installation in our Fast Path Installation Guide. Feel free to open an issue in GitHub if you find any issues.

Step 1: Download and install the ZIP files

  Invoke-WebRequest -UseBasicParsing -Uri https://raw.githubusercontent.com/FusionAuth/fusionauth-install/main/install.ps1 | iex
cd fusionauth

Step 2: Start FusionAuth

  bin\startup.ps1

Then open http://localhost:9011 in your browser.

Debian Package

Debian Package

Follow the steps below to install FusionAuth on a Debian/Ubuntu style Linux. This installation method installs the FusionAuth platform packages (DEBs) and will require sudo or root access. This command assumes you are using Bash. You might need to modify it if you are using a different shell. You'll also need to manually install a database for FusionAuth to work. Feel free to open an issue in GitHub if you find any issues.

VERSION=$(curl -fsSL https://license.fusionauth.io/api/latest-version) && \
curl -fsSL https://files.fusionauth.io/products/fusionauth/${VERSION}/fusionauth-app_\${VERSION}-1_all.deb > fusionauth-app_\${VERSION}-1_all.deb && \
sudo dpkg -i fusionauth-app_\${VERSION}-1_all.deb && \
sudo systemctl start fusionauth-app

Then open http://localhost:9011 in your browser.

Red Hat Package

Red Hat Package

Follow the steps below to install FusionAuth on Red Hat or other RPM-based distribution. This installation method installs the FusionAuth platform packages (RPMs) and will require sudo or root access. This command assume s you are using Bash. You might need to modify it if you are using a different shell. You'll also need to manually install a database for FusionAuth to work. Feel free to open an issue in GitHub if you find any issues.

VERSION=$(curl -fsSL https://license.fusionauth.io/api/latest-version) && \
curl -fsSL https://files.fusionauth.io/products/fusionauth/${VERSION}/fusionauth-app-${VERSION}-1.noarch.rpm > fusionauth-app-${VERSION}-1.noarch.rpm && \
sudo rpm -i fusionauth-app-${VERSION}-1.noarch.rpm && \
sudo systemctl start fusionauth-app

Then open http://localhost:9011 in your browser.

Homebrew

Homebrew Installation

Copy and paste each command below into Terminal to install using Homebrew. You'll also need to manually install a database for FusionAuth to work. You can also review our Homebrew Installation Guide for more information. Feel free to open an issue in GitHub if you find any issues.

Step 1: Tap the FusionAuth package, this will only need to be performed once

        brew tap fusionauth/homebrew-fusionauth

Step 2: Install the FusionAuth tap, this will only need to be performed once

        brew install fusionauth-app

Step 3: Start the FusionAuth service

        brew services start fusionauth-app

Than open http://localhost:9011 in your browser.

Google KE
Microsoft AKS
Amazon EKS
Minikube

Google Kubernetes Engine

Follow the steps below to install FusionAuth on Kubernetes using Helm. You’ll need to have a running kubernetes cluster, please visit our documentation for specific steps for cluster setup instructions. You'll need to update values.yml with database and Elasticsearch configuration information. Please review the Kubernetes Installation Guide for more details. Feel free to open an issue in GitHub if you find any issues.

helm repo add fusionauth https://fusionauth.github.io/charts && \
curl -o values.yaml https://raw.githubusercontent.com/FusionAuth/charts/master/chart/values.yaml && \
helm install my-release fusionauth/fusionauth -f values.yaml && \
export SVC_NAME=$(kubectl get svc --namespace default -l "app.kubernetes.io/name=fusionauth,app.kubernetes.io/instance=my-release" -o jsonpath="{.items[0].metadata.name}") && \
kubectl port-forward svc/$SVC_NAME 9011:9011

Then open http://localhost:9011 in your browser.

Microsoft Azure Kubernetes Service

Follow the steps below to install FusionAuth on Kubernetes using Helm. You’ll need to have a running kubernetes cluster, please visit our documentation for specific steps for cluster setup instructions. You'll need to update values.yml with database and Elasticsearch configuration information. Please review the Kubernetes Installation Guide for more details. Feel free to open an issue in GitHub if you find any issues.

helm repo add fusionauth https://fusionauth.github.io/charts && \
curl -o values.yaml https://raw.githubusercontent.com/FusionAuth/charts/master/chart/values.yaml && \
helm install my-release fusionauth/fusionauth -f values.yaml && \
export SVC_NAME=$(kubectl get svc --namespace default -l "app.kubernetes.io/name=fusionauth,app.kubernetes.io/instance=my-release" -o jsonpath="{.items[0].metadata.name}") && \
kubectl port-forward svc/$SVC_NAME 9011:9011

Then open http://localhost:9011 in your browser.

Amazon Elastic Kubernetes Service

Follow the steps below to install FusionAuth on Kubernetes using Helm. You’ll need to have a running kubernetes cluster, please visit our documentation for specific steps for cluster setup instructions. You'll need to update values.yml with database and Elasticsearch configuration information. Please review the Kubernetes Installation Guide for more details. Feel free to open an issue in GitHub if you find any issues.

helm repo add fusionauth https://fusionauth.github.io/charts && \
curl -o values.yaml https://raw.githubusercontent.com/FusionAuth/charts/master/chart/values.yaml && \
helm install my-release fusionauth/fusionauth -f values.yaml && \
export SVC_NAME=$(kubectl get svc --namespace default -l "app.kubernetes.io/name=fusionauth,app.kubernetes.io/instance=my-release" -o jsonpath="{.items[0].metadata.name}") && \
kubectl port-forward svc/$SVC_NAME 9011:9011

Then open http://localhost:9011 in your browser.

Minikube

Follow the steps below to install FusionAuth on Kubernetes using Helm. You’ll need to have a running kubernetes cluster, please visit our documentation for specific steps for cluster setup instructions. You'll need to update values.yml with database and Elasticsearch configuration information. Please review the Kubernetes Installation Guide for more details. Feel free to open an issue in GitHub if you find any issues.

helm repo add fusionauth https://fusionauth.github.io/charts && \
curl -o values.yaml https://raw.githubusercontent.com/FusionAuth/charts/master/chart/values.yaml && \
helm install my-release fusionauth/fusionauth -f values.yaml && \
export SVC_NAME=$(kubectl get svc --namespace default -l "app.kubernetes.io/name=fusionauth,app.kubernetes.io/instance=my-release" -o jsonpath="{.items[0].metadata.name}") && \
kubectl port-forward svc/$SVC_NAME 9011:9011

Then open http://localhost:9011 in your browser.

Helm

Helm Package Manager

Follow the steps below to install FusionAuth on Kubernetes using Helm. You'll need to update values.yml with database and Elasticsearch configuration information. Please review the Kubernetes Installation Guide for more details. Feel free to open an issue in GitHub if you find any issues.

helm repo add fusionauth https://fusionauth.github.io/charts && \
curl -o values.yaml https://raw.githubusercontent.com/FusionAuth/charts/master/chart/values.yaml && \
helm install my-release fusionauth/fusionauth -f values.yaml && \
export SVC_NAME=$(kubectl get svc --namespace default -l "app.kubernetes.io/name=fusionauth,app.kubernetes.io/instance=my-release" -o jsonpath="{.items[0].metadata.name}") && \
kubectl port-forward svc/$SVC_NAME 9011:9011

Then open http://localhost:9011 in your browser.

Packages

Package Downloads

Looking for our standard packages (DEB, RPM and ZIPs)? They are stored in our direct downloads.

FusionAuth Cloud

FusionAuth Cloud

You can sign up for a free trial of FusionAuth running in our fully managed Cloud. Feel free to open an issue in GitHub if you find any issues.

start free trial

Gitpod Classic

Gitpod Classic

Launch FusionAuth in a Gitpod Classic environment. If you have a Gitpod Enterprise account, you can also launch FusionAuth. Feel free to open an issue in GitHub if you find any issues.