This repo holds an example Express.js application that uses FusionAuth as the identity provider. This application will use an OAuth Authorization Code Grant workflow to log a user in and get them access and refresh tokens.
The docker-compose.yml file and the kickstart directory are used to start and configure a local FusionAuth server.
The /app directory contains the application.
- Docker, for running FusionAuth
- Node 22 or later, for running the application
In the root of this project directory (next to this README) are two files a Docker compose file and an environment variables configuration file. Assuming you have Docker installed on your machine, you can stand up FusionAuth up on your machine with:
docker compose up -d
The FusionAuth configuration files also make use of a unique feature of FusionAuth, called Kickstart: when FusionAuth comes up for the first time, it will look at the Kickstart file and mimic API calls to configure FusionAuth for use when it is first run.
NOTE: If you ever want to reset the FusionAuth system, delete the volumes created by docker compose by executing
docker compose down -v.
FusionAuth will be initially configured with these settings:
- Your client Id is:
e9fdb985-9173-4e01-9d73-ac2d60d1dc8e - Your client secret is:
super-secret-secret-that-should-be-regenerated-for-production - Your example username is
richard@example.comand your password ispassword. - Your admin username is
admin@example.comand your password ispassword. - Your fusionAuthBaseUrl is 'http://localhost:9011/'
You can log into the FusionAuth admin UI and look around if you want, but with Docker/Kickstart you don't need to.
To run the application, first go into the project directory
cd applicationInstall dependencies
npm installStart the application
npm run devGo to https://localhost:8080 to log in and make some change.
Magic links don't work on safari when using localhost.
Use chrome or firefox instead.