Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Disconnect between setting up the server and client in the QuickStart guide #2705

Open
bjenkinsgit opened this issue Apr 14, 2024 · 2 comments

Comments

@bjenkinsgit
Copy link

Is your feature request related to a problem? Please describe.
I'm referring to the QuickStart guide at: https://kanidm.github.io/kanidm/stable/quickstart.html
The QuickStart guide gives a nice step-by-step set of instructions that is split into two areas: server and client
The server part was fine and I had no trouble getting the Kanidm docker container with the server up and running.

A clear description of what the problem is. Ex. I'm confused by, or would like to know how to...

The confusion happens in the transition from server to client where it goes from using the idm_admin account to administrating users and groups and then the client area starts off with a needed config file that tells Kanidm where to find the server and issuing the command "kanidm login --name idm_admin" in the "Check you can login" section.

My issue was I did not have the client CLI kadnim tool installed.

Describe the solution you'd like
Just a paragraph that reminds the user to install kadnim client on their system. For me it was on Mac so I used home-brew to install kadnim cli.

I will try to locate that part of the quick start and suggest a PR with a bit of added text.

@Firstyear
Copy link
Member

I think this was something that Alex noted, part of the "fun" with the client setup though is that it varies from platform to platform. That adds some challenges here, but I think we can resolve it.

@mpalmer
Copy link

mpalmer commented May 4, 2024

It'd be enough, probably, just to point to the "Installing Client Tools" section of the book. I just bumped into this same problem, and since "Evaluation Quickstart" is before "Installing Client Tools", I hadn't gotten to there yet and didn't realise I needed to.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Status: 📋 Backlog
Development

No branches or pull requests

4 participants