Logo / Docs

First Time Setup

These configuration steps are common to almost all FusionAuth installations. Take these steps to avoid being inadvertently locked out of your FusionAuth server.

Access FusionAuth App#

You will need to access FusionAuth in your web browser. If you have installed FusionAuth on your own system, you will need to know the IP address or hostname of the system where it has been installed, often http://localhost:9011.

Once you have a web browser open to FusionAuth you will be presented with a setup wizard that will walk you through getting FusionAuth configured and ready to begin calling the API and managing users. If you instead are being prompted by the FusionAuth Maintenance Mode, please complete that setup first and then return to this step. See the Maintenance Mode section in the FusionAuth App Installation Guide.

Once the setup wizard is complete you will be logged into FusionAuth using the created Administrator account.

Complete the Setup Wizard#

Setup Wizard

Configure An Email Server#

Email is used for many purposes in FusionAuth, including to verify user email addresses and for passwordless authentication. However, one of the most important functions is to allow for forgotten passwords.

First Time Setup email server

Full instructions on how to configure your email server settings.

If you lose your password, you can reset it using the Forgot Password link on the login screen.

Add a Second Admin User#

Create a second user with the admin role. This user can provide access should your initially created admin user lose access for any reason.

  • Log in to the administrative user interface.
  • Navigate to Users .
  • Add a user with a known, valid email address and secure password within your organization.
  • Register that user with the FusionAuth application and the admin role.

Activate License Key#

Activating the license key will allow access to all of the paid features inside FusionAuth. The key is found in your account portal and is activated in the Reactor tab.

First time setup license

Production keys must be used for any FusionAuth instance that customers will be logging into, that is how we track MAUs.

Non-production keys may be used for any other instances such as your developers’ laptops, QA, or UAT.

  • Log in to the administrative user interface.
  • Navigate to Plan and copy the appropriate key.
  • Access the FusionAuth instance and navigate to the Reactor .
  • Paste that key into the License Key field and Activate it.

Full instructions on how to activate your license.

Set Up an API Key#

Create an API key you can use to manage FusionAuth in an emergency. If you lose access to the administrative user interface, you can use this API key to retain access to your FusionAuth instance by adding a new admin user.

  • Log in to the administrative user interface.
  • Navigate to Settings -> API Keys .
  • Add an API Key with no limitations. This will make it a super user key with no limitations.
  • Note the key value, and store it someplace safe.

First Time Setup API key

Modify the Tenant Issuer#

The Issuer , found by navigating to Tenants -> Your Tenant -> General defaults to acme.com. This is not usually what you want.

This value is used by any JWTs created by the OAuth grants or the Login API.

While the exact value you change this to varies based on how you are using FusionAuth, a typical value is the URL of the FusionAuth instance, such as https://auth.example.com.