## Documentation

- About
- Read First
  - What is IdentityServer
  - Installation Scenarios
- Migrations
- Bootstrapping
- Configuration & Integration
  - AdminUI Settings
  - Configuring AdminUI
  - Configuring AdminUI (NuGet)
  - Integrating with Identity Server
  - Integrating with Identity Server Custom Schema
  - Integrating with Quickstarts
  - Enabling Logging
- Installation
  - Installer
  - IIS
  - Azure
    - Install in Azure
    - Create Azure Web App
  - Docker
  - NuGet
- Custom Database Connections
- Custom Identity Store
  - Overview
  - Partial Implementation
  - Full Implementation
  - Tenancy With Entity Framework
  - NoSql Implementation (MongoDB)
- Custom CSP
- Users
  - Searching for Users
  - Adding Users
  - Editing Users
  - Deleting Users
  - Merge Users
  - Set User Password
  - Session Management
  - User Reports
  - Bulk User Import
- Roles
  - Creating Roles
  - Managing Roles
  - Managing Users in a Role
  - Managing Role Claims
- Claim Types
- Clients
  - Searching for Clients
  - Adding Clients
  - Adding a SAML Client
  - Adding a WS-Fed Client
  - Editing Clients
  - Deleting Clients
  - Clone Client
- Import and Export
  - Exporting Clients
  - Importing Clients
  - Importing Client Configuration with Secrets
  - Importing SAML Clients with Certificates
  - Import and Export Via the API
- Dynamic Authentication Providers
  - What is Dynamic Authentication
  - Enabling or disabling Dynamic Authentication
  - Add a Dynamic Provider
    - First Steps
    - Adding OIDC Provider
    - Adding SAML Provider
  - Edit a Dynamic Provider
    - Accessing edit view
    - Editing a OIDC Provider
    - Editing a SAML Provider
  - Deleting a Provider
  - Searching for Provider
- Resources
  - Searching for Resources
  - Creating Resources
  - Editing resources
- Webhooks
  - Webhooks
  - Endpoint Configuration
- User Settings Endpoints
- Access Policy
- Keys
- Auditing
- FAQs
- Troubleshooting
  - Unable to start AdminUI
  - Unable to contact IdentityServer
  - Unable to contact API
  - Unable to log in

### Installation Scenarios

- -Installation Scenarios
- -I have neither IdentityServer or AdminUI installed
- -I have IdentityServer 3.X or above installed.
- -I have IdentityServer4 2.2 or below and no installation of AdminUI
- -I have IdentityServer4 2.2 or below and AdminUI 2.0 - 2.3 installed
- -I have IdentityServer4 2.3 or above installed and no AdminUI
- -I have IdentityServer4 2.3 or above installed and AdminUI 2.4 or above installed
- -Migrations

## Installation Scenarios

#### I have neither IdentityServer or AdminUI installed

See here for a introduction to IdentityServer and where AdminUI fits in.

If you haven't already requested a demo, you can get one from here where you will receive a download link for AdminUI plus a 30 day demo license key.

For IdentityServer, we recommend using our quickstart, that is already integrated with AdminUI.

You can then follow one of the walkthroughs below to install AdminUI

- IIS
- Azure
- Docker

#### I have IdentityServer 3.X or above installed.

Download and install the AdminUI version that matches up with your IdentityServer version. With the introduction of IdentityServer Duende we will be keeping the same model but also including IdentityServer4 v4 support up until End of Life (EOL). From AdminUI version 7.0 IdentityServer4 support has been removed.

Supported Versions:

AdminUI | Duende IdentityServer | IdentityServer4
--- | --- | ---
v3.x | - | v3
v4.x | - | v4
v5.x | v5 | v4
v6.x | v6 - v6.2 | v4
v7.x | v6.3 | -
v8.x | v7 | -

Run the "all" command in the Migrations section below.

#### I have IdentityServer4 2.2 or below and no installation of AdminUI

You will need to migrate your IdentityServer database to the IdentityServer 2.3 schema. The simplest way is to upgrade your IdentityServer packages to 2.3 and generate the migrations, you can find out more on generating your own IdentityServer migrations here.

#### I have IdentityServer4 2.2 or below and AdminUI 2.0 - 2.3 installed

If you previously requested that AdminUI run the IdentityServer migrations then run the migrate all command, otherwise, you will need to upgrade your IdentityServer4 to 2.3 and generate your own migrations.

#### I have IdentityServer4 2.3 or above installed and no AdminUI

Install AdminUI 2.X, and run all migrations but the IdentityServer migration, see the migrations link below.

#### I have IdentityServer4 2.3 or above installed and AdminUI 2.4 or above installed

Install the latest version of AdminUI, update your configuration, and then run the migrate all command, see below.

## Migrations

Whether you are installing AdminUI for the first time or upgrading to the latest version of AdminUI, you will need to run some form of migrations to ensure your databases are inline with AdminUI, if you want AdminUI to handle all migrations you can navigate to the folder where your AdminUI site is and run the following command.

    dotnet IdentityExpress.Manager.UI.Duende.dll -migrate all

It will generate the databases for you using the connection strings configured in your AdminUI appsettings.json

If you are planning on managing some of the database migrations yourself, or want more options when setting up your databases, then there are more fine tune migrations you can do, for more info see our full migration docs here

Previous Next