Setup Wizard & First Login
This tutorial guides you through completing the initial FusionAuth configuration necessary prior to making API calls and beginning your integration.
Access FusionAuth App
The first step is 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. For example, to access FusionAuth on localhost, you would use the following URL
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
This will be the first account to be created in FusionAuth and this user will be assigned the
admin role the FusionAuth application. Additional
users can be assigned the
admin role at a later time.
To complete the setup wizard you must toggle the Accept button after reading the FusionAuth license agreement. You won’t find any surprise strings attached here, just the normal lawyer speak for CYA.
Optionally stay informed by opting-in to receive FusionAuth technical announcements, tutorials and other technical focused emails. You may opt-out at any time in the future, or opt-in at a later date by visiting fusionauth.io and finding the "Subscribe for updates" form at the bottom of the page.
Once the Setup Wizard has logged you into FusionAuth you may begin using FusionAuth. On the dashboard you will see the remaining setup items. This includes setting up an API key, creating an Application and completing the SMTP Email configuration.
FusionAuth can be configured with one to many Applications. A FusionAuth Application represents a secured resource, it should be thoughtfully named but the name may be modified at a later time. See the Application overview for additional details.
Missing API Key
In order to call the API at least one API key will need to be added. Additional API keys can be added at a later time by any user with the
api_key_manager roles. See API Authentication for additional details.
It is recommended that you create an API key and store it somewhere safe such as a secrets manager. If you forget your password, misconfigure an Identity Provider, or otherwise render your FusionAuth administrative user interface inaccessible, you can use the API key to modify your configuration.
This step is optional but it is recommended. Until FusionAuth has been configured with a valid SMTP configuration FusionAuth will be unable to send email. This means features such as Forgot Password, Change Password, Verify Email and User Actions configured to send emails will not function.
See the Configure Email section for additional details.