Creating new user from NixOS Module Declaration

[Kruziikrel13]

tl;dr; Outside of the demo vm / using the NixOS module, how can I create a new user which I can login as in the Web UI, as well as create an API key to use with circusctl

---

I might be early to the party with using this. But I was JUST about to setup hydra for automated binary cache builds, and saw this and figured I'd go with this to save time having to dramatically reimpl CI.

I am using the next branch currently. I am instantiating Circus like below. Using the NixOS Module, and for now I aim to just get the server properly up and running and get into it etc.
https://git.hjaalmarch.dev/kruziikrel13/NixOS/src/branch/master/modules/services/circus.nix

I couldn't find anything in docs regarding a prod setup for creating a user, it only appeared the demo vm has been documented... or perhaps I missed the docs.

Just create the user through psql?

[NotAShelf]

There are currently three ways to create your first user/API key:

1. NixOS module declarative config (your case), .e., declarative.users and declarative.api_keys. Since Circus is meant to be declarative, this is the recommended path
2. Direct psql, I believe this is documented in INSTALL.md for API keys
3. circusctl admin users create, works only after you have an admin key.

circusctl can do it but you need a bootstrap key first. I'll be updating the usage documentation to describe the first-user setup shortly. Also, from your configuration I can see that you've set API key in plaintext. This is okay for, e.g., read-only keys but it's a security issue when used with admin keys. I would encourage you to use key_file instead.

P.S.: you're a little early, but it's not necessarily a bad time to adopt Circus. I welcome feedback, and Circus is already deployed for our infrastructure so we catch critical bugs early.

[NotAShelf]

Updated the documentation in 705061b