cat2-admin
– Caterva2 server administration#
This program provides administration commands for managing a Caterva2 server. These commands are meant to be used on the same machine as the server and typically require access to the server’s state directory.
Installation#
To use cat2-admin
, you need to install Caterva2 with the server extra:
python -m pip install caterva2[server]
Usage#
cat2-admin [GLOBAL_OPTIONS...] COMMAND [COMMAND_OPTIONS...] COMMAND_ARGUMENTS...
Global Options#
--statedir PATH
: Specify the state directory for the server (default:_caterva2/sub
)--help
: Show help message and exit
Commands#
adduser
- Add a user to the server database#
Add a new user to the server database.
cat2-admin adduser [OPTIONS] USERNAME [PASSWORD]
Arguments:
USERNAME
: Username for the new userPASSWORD
: Password for the new user (optional, will be generated if not provided)
Options:
--superuser
,-S
: Make the user a superuser--help
: Show help for this command
Examples:
# Add a regular user with auto-generated password
cat2-admin adduser alice
# Add a superuser with a specific password
cat2-admin adduser bob mypassword --superuser
# Add a user to a custom state directory
cat2-admin --statedir /custom/path adduser charlie
Configuration#
cat2-admin
uses the same configuration system as other Caterva2 tools. It can read settings from a TOML configuration file (caterva2.toml
in the current directory unless overridden).