Evaluation Quickstart

This section will guide you through a quick setup of Kanidm for evaluation. It's recommended that for a production deployment you follow the steps in the installation chapter instead as there are a number of security considerations you should understand.

Requirements

docker or podman
x86_64 cpu supporting x86_64_v2 OR aarch64 cpu supporting neon

Get the software

docker pull kanidm/server:latest

Configure the container

docker volume create kanidmd
docker create --name kanidmd \
  -p 443:8443 \
  -p 636:3636 \
  -v kanidmd:/data \
  kanidm/server:latest

Configure the server

Create server.toml

{{#rustdoc_include ../../examples/server_container.toml}}

Add configuration to container

docker cp server.toml kanidmd:/data/server.toml

Generate evaluation certificates

docker run --rm -i -t -v kanidmd:/data \
  kanidm/server:latest \
  kanidmd cert-generate

Start Kanidmd Container

docker start kanidmd

Recover the admin password

docker exec -i -t kanidmd \
  kanidmd recover-account admin

Setup the client configuration

# ~/.config/kanidm

uri = "https://localhost:443"
verify_ca = false

kanidm login

What next?

You can now follow the steps in the administration section

1.4 KiB Raw Blame History