Install

yarn install or npm run install

Setup keycloak

You can run the keycloak server using the keycloak-docker config provided in this repository.

• cd keycloak-docker
• cp .env.example .env
• docker compose up -d
• go to http://localhost:8080 and login with u:admin p:password
• create a new realm
• create new client in that realm, with the following options: screenshot1, screenshot2. Very important: make sure to add a + in "Web origins" field.
• create a user
• [done]

Setup Nextjs app

• cp .env.example .env
• setup env variables
• yarn dev
• [done]

Adjusting Access Token Lifetime in Keycloak

Access token is used to keep the user logged in for a short time.

• go to your Reaml Settings
• click on tab Tokens
• set the access token lifetime by adjusting Access Token Lifespan

Adjusting Refresh Token Lifetime in Keycloak

Refresh token is used to get a new access token periodically. If you want to keep the user logged in for a long time, even if they return to the app days later, one way to achieve that is by adjusting the Refresh Token Lifetime.

• go to your Reaml Settings
• click on tab Sessions
• set the refresh token lifetime by adjusting SSO Session Max value.