gpg-lacre/doc/admin.md

Lacre administration

Command-line tool

There's a little tool for administrators. As long as Lacre Python packages are available via PYTHONPATH, you can use it like this:

python -m lacre.admin -h

Of course -h displays some help.

Note: Help output includes information about the configuration file being in use, which may be useful at times.

Note: You can also use a tiny shell wrapper around this tool, see bin/lacreadm.

Initialising database schema

If you want to initialise Lacre's database (which is also used by the frontend), run:

python -m lacre.admin database -i

Inspecting key confirmation queue

To find out how many keys are waiting to be confirmed, run:

python -m lacre.admin queue

To see identities (emails) waiting for confirmation, use --list (or -l) option:

python -m lacre.admin queue -l

To delete one of these emails, use --delete (or -d) option:

python -m lacre.admin queue -d malory@example.org

Inspecting identities registered

To list all identities, run:

python -m lacre.admin identities -a

To preview a particular identity, run:

python -m lacre.admin identities -e alice@example.com

Importing identities from existing GnuPG keyring

If you already have a GnuPG keyring with your users' public keys or for some reason Lacre's identity database needs to be re-populated with identities, there's a command to do that:

python -m lacre.admin import -d /path/to/gnupg/directory

If you want to just re-populate the database, Lacre can remove all identities prior to importing keys -- just add -r flag.