aboutsummaryrefslogtreecommitdiffstats
path: root/README
blob: 687bf4560044c70298efe19567914a63be022fb5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
These are administrative tools used by Fripost - the Free E-mail Association.

Visit our website for more information:
http://fripost.org/

Please send patches, bug reports and comments to:
skangas@skangas.se

#. Installation

Read installation file INSTALL and follow those instructions.

Copy file fripost.yml.template to ~/.fripost.yml, edit it, chmod 0600 it, and
add the following:

    bind_dn: <admin bind DN>
    bind_pw: <admin bind password>

where <admin bind username> and <admin bind password> your own admin DN
and password.

Configure a local Mail Transger Agent (MTA) for example exim4:

    $ sudo dpkg-reconfigure exim4-config

Choose use smarthost for outgoing and no local e-mail. Choose your IPS's SMTP
server for outgoing e-mail.

#. Log in to server

    $ ssh -vNfL 389:localhost:389 <remote server>

This opens an ssh-tunnel and returns to standard prompt. Locally, you may want
to use the standard LDAP port 389, or some unprivileged port.

#. Add a new mailbox.

    $ fripost-adduser

#. Create a random new password

    $ fripost-mkpass

#. Add a new alias to the system

    $ fripost-newalias

The script prompts first for goto address, which is where the new alias is
supposed to point to, and later for alias. It is not necessary to add domain for
goto address, BUT for alias address.

#. Add a new domain to the system

    $ fripost-newdomain

#. Change password of user

    $ fripost-passwd

All these scripts have an integrated manual you can read using e.g.,
`fripost-adduser --man'. A short help is also available with e.g.,
`fripost-adduser --help'.

Have fun!

License information is in COPYING.

This document is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.