1. Setup Wizard
This tutorial guides you through completing the initial FusionAuth configuration necessary prior to making API calls and beginning your integration.
1.1. 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.
1.2. Complete the Setup Wizard
1.2.1. Administrator account
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.
1.2.2. FusionAuth license
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.
1.2.3. Stay informed
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.
2. Complete Setup
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.
2.1. Missing Application
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 Add an Application Tutorial for additional details.
2.2. 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
admin role. See the Add an API Key Tutorial for additional details.
2.3. Email Settings
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.