diff options
| -rw-r--r-- | index.mdwn | 51 |
1 files changed, 33 insertions, 18 deletions
@@ -125,16 +125,21 @@ Note for Debian users: you'll need the "expect" package to run firma. Firma installation is quite simple: -1. Create a folder to store lists; by default firma use `/var/lib/firma/lists` - but you can use anything, just edit firma and change `FIRMA_LIST_PATH` - variable. +### List folder -2. Copy firma script to whatever you like, e.g. `/usr/local/bin` and check that - it has no write permission +Create a folder to store lists; by default firma use `/var/lib/firma/lists` but +you can use anything, just edit firma and change `FIRMA_LIST_PATH` variable. -3. Create a list-wide config file (default is `/var/lib/firma/firma.conf`) with - the common definitions for all lists. You might just copy the sample - firma.conf.dist and edit according to your needs. +### Script installation + +Copy firma script to whatever you like, e.g. `/usr/local/bin` and check that it +has no write permission + +### Global config + +Create a system-wide config file (default is `/var/lib/firma/firma.conf`) with +the common definitions for all lists. You might just copy the sample +firma.conf.dist and edit according to your needs. All config variables can be overwritten at each list's own config file; firma.conf should be chmoded as `600`, chowned `nobody.nobody` or whatever user @@ -145,7 +150,9 @@ For a list of all config parameters, type firma --help config -4. Then create your lists with the command +### List creation + +Then create your lists with the command firma -c your-list @@ -185,12 +192,14 @@ After that you can add some optional parameters on this list config file: this doesn't affect the way email administration works, when signature is mandatory - For a list of all config parameters, type +For a list of all config parameters, type firma --help config -6. Create an alias to the list at your MTA; on sendmail or postfix, - add this to your aliases file: +### MTA configuration + +Create an alias to the list at your MTA; on sendmail or postfix, add this to +your aliases file: your-list: "| /usr/local/bin/firma -p your-list" your-list-request: "| /usr/local/bin/firma -e your-list" @@ -202,8 +211,10 @@ and then run the command alternatively, you can use a virtual mailbox table if you want to easily host a lot of encrypted mailing lists. -7. Admin tasks are performed through aliases like your-list-request@yourmachine - or via command-line: +### List administration + +Admin tasks are performed through aliases like your-list-request@yourmachine +or via command-line: firma -a your-list @@ -225,15 +236,19 @@ following commands: uses the given address for message delivery instead of the primary address of a subscribed key -8. To subscribe and unsubscribe manually the users and the list admins on, use - a command line like +### Subscription management + +To subscribe and unsubscribe manually the users and the list admins on, use +a command line like gpg --homedir [path-to-your-list-keyring] --import < file and be sure that after this command the list keyring is owned by nobody.nobody. -9. Send encrypted AND signed messages to `your-list@yourmachine` and look - what happens :) +### Testing the installation + +Send encrypted AND signed messages to `your-list@yourmachine` and look +what happens :) Tips ---- |