]> code.citadel.org Git - citadel.git/blob - citadel/docs/inetsiteconfig.txt
* Updated the documentation some more
[citadel.git] / citadel / docs / inetsiteconfig.txt
1   
2
3
4
5 This document explains the (.A) (S)ystem (I)nternet command. 
6
7 Lobby> .Aide System Configuration Internet
8
9 ###                    Host or domain                     Record type
10 --- -------------------------------------------------- --------------------
11   1
12 (A)dd (D)elete (S)ave (Q)uit  ->
13
14 This is a 'clean' set up. Pixel uses the mx method because we have local
15 users who get e-mail on the system. Basically to get all set up for mail
16 you simply have to type <a>dd: 
17
18 (A)dd (D)elete (S)ave (Q)uit  -> Add
19
20 Enter host name: pixel.citadel.org
21  (1) localhost       (Alias for this computer)
22  (2) gateway domain  (Domain for all Citadel systems)
23  (3) smart-host      (Forward all outbound mail to this host)
24  (4) directory      (Consult the Global Address Book)
25  (5) SpamAssassin   (Address of SpamAssassin server)
26
27
28 Which one [1]:
29
30 Basically what you're doing here is telling Citadel what any aliases for
31 your machine are. If your machine were pixel.somedomain.com and you also
32 had a DNS entry set up byFreakdog (freakdog @dogpound2), you might want to
33 put in pixel.citadel.org as your alias, so that e-mail sent to that
34 address won't bounce. 
35
36 Gateway Domain:
37 citadel.org (that's the current domain for Citadel/UX systems)
38
39 smart-host:
40 A host to which you send all e-mail to be forwarded to the Internet. In
41 most cases you won't need this, however I speak from experience when I say
42 that if you don't have a static IP and domain name (the citadel.org 
43 addresses are dynamically assigned) a lot of MTA filters will block
44 mail from your address. So unless you have a static domain, you'll 
45 probably want to send mail through a smart host. Usually your ISP will
46 provide you with that information.
47  
48 directory:
49 A domain for which you are participating in directory services, perhaps across
50 any number of Citadel nodes.  This is new and not fully supported yet.
51
52 SpamAssassin:
53 You can configure Citadel to use the excellent SpamAssassin software (read
54 more at http://www.spamassassin.org to learn about it) to filter out incoming
55 spam from your system.  Learn how to do this by reading the documentation
56 at http://www.citadel.org/spamassassin.php
57
58 All you have to do is save and you're done.