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
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 | - |
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.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