Step 1 - Install FusionAuth
First, you need an instance of FusionAuth. The easiest place to install? The machine you are currently using to read this page.
Use the following Docker Compose commands to get up and running quickly with FusionAuth, PostgreSQL, and Opensearch:
-
Install the prerequisites:
- On macOS and Windows, one of the following container management tools:
- Docker desktop
- OrbStack (to use Orbstack for
docker composecommands after install, rundocker context use orbstack) - Podman (in the commands below, replace
dockerwithpodman)
- On Linux, Docker 23 or later
- On macOS and Windows, one of the following container management tools:
-
Download the
docker-compose.ymland.envfiles: -
Start the FusionAuth container:
docker compose up -d -
Visit http://localhost:9011 to access the Admin UI.
-
Congratulations, you have a working instance of FusionAuth! To set up login for an application, see our First Time Setup guide.
Open the web UI#
Open a browser to http://localhost:9011/admin and you'll be presented with the FusionAuth login page. The installation instructions above used Kickstart, which created an admin user:
- Username:
admin@example.com - Password:
password
To log into the FusionAuth Admin UI, click the lock icon in the top right. The Admin UI helps you monitor and configure all of the users, roles, applications, and identity providers you'll use with FusionAuth.
Once you've thoroughly explored the UI, log out before proceeding to the next step. The next set of steps all work with an admin user, but it's better to demonstrate login and protected pages as a non-admin instead. To log out, click the Log out button in the top right.