/Docs

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:

  1. Install the prerequisites:

    • On macOS and Windows, one of the following container management tools:
      • Docker desktop
      • OrbStack (to use Orbstack for docker compose commands after install, run docker context use orbstack)
      • Podman (in the commands below, replace docker with podman)
    • On Linux, Docker 23 or later

  2. Download the docker-compose.yml and .env files:

  3. Start the FusionAuth container:

    docker compose up -d

  4. Visit http://localhost:9011/admin to access the Admin UI.

  5. 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.

Next steps#

Step 2: Login Button

->