Tutorials

This guide walks through the initial setup of a new TokenIDP environment. It is intended for administrators and developers who are installing TokenIDP for the first time.

By the end of this guide, you will have:

  • Started the TokenIDP host.
  • Initialized the platform using the bootstrap process.
  • Created the initial Tenant and administrator account.
  • Configured browser origins for local development.
  • Registered an application.
  • Completed a working Authorization Code Flow with PKCE.

The setup steps are organized in the same sequence most teams follow during a new installation. Complete each section in order before moving to production configuration and advanced features.

Prerequisites

Before starting, ensure that:

  • The .NET 10 SDK is installed.
  • A SQL Server/PostgreSQL is available.
  • You have access to the TokenIDP source code or deployment package.

Available Tutorials

Troubleshooting

  • If startup fails, inspect database connectivity and the ConnectionStrings section first.
  • If the browser is redirected back with an OAuth error, compare the configured redirect URI to the one registered for the Application.