Installing ZITADEL on NixOS Latest

This tutorial will guide you through the process of installing ZITADEL on NixOS Latest platform. ZITADEL is an open source IAM solution based on the OAuth 2.0 protocol with adaptable consent for an improved user experience.

Prerequisites

Before you proceed with the installation, make sure you have the following prerequisites ready:

  • An instance of NixOS Latest
  • Access to the terminal of the NixOS instance
  • An internet connection

Installing ZITADEL

  1. Open the terminal of your NixOS instance.

  2. Clone the ZITADEL repository using the following command:

    $ git clone https://github.com/caos/zitadel.git

  3. Switch to the ZITADEL directory:

    $ cd zitadel

  4. Install the necessary dependencies by running:

    $ sudo nix shell nixpkgs#jq nixpkgs#curl --command true

  5. Generate the configuration for ZITADEL using:

    $ ./dependent/clean-config.sh
$ ./dependent/gen-config.sh

  6. Edit the generated configuration file (zitadel.development.local.yml) to suit your needs.

  7. Install the database using the following command:

    $ docker-compose -f dependent/docker-compose.yml up -d

  8. Start ZITADEL with the following command:

    $ docker-compose -f docker-compose.yml up

  9. Go to your web browser and navigate to localhost:8282. You should be able to see the ZITADEL login page.

Congratulations! You have successfully installed ZITADEL on NixOS Latest. You can now start managing your identity access with ZITADEL.