1 Citadel/UX Internet E-mail setup instructions (native Citadel/UX version)
3 This document explains how to set up your citadel as an Internet e-mail
4 capable system. Once you are through with this document you should be able to
5 have your users send mail from, and receive mail to
6 systemname@system.citadel.org. For example to send e-mail to a user at
7 Uncensored! BBS via e-mail you would do the following:
8 mail patriot@uncensored.citadel.org
10 To set this up is almost insanely simple.
12 1. Check for the existance of a current MTA (sendmail, qmail, etc):
13 If you see something similar to the following you're running an MTA
14 already and you'll need to shut it down:
17 smw @ pixel % telnet localhost 25
19 Connected to localhost.
20 Escape character is '^]'.
21 220 pixel.citadel.org ESMTP Sendmail 8.9.3/8.9.3; Wed, 15 Mar 2000 19:00:53 -0500
26 The above shows that pixel is running Sendmail version 8.9.3 and the
27 current date. What this means is that Pixel is running the MX version of
28 bbs e-mail, which is described in inetmailsetupmx.txt.
30 If you get a 'connection refused' message when you telnet to port 25 there's
31 nothing running and you should be able to continue. You might also want to
32 turn off POP (try the above test substituting 110 for 25) and IMAP (port 143)
33 and use Citadel's POP and IMAP services.
35 The POP and IMAP services will ONLY allow retrieval of mail for Citadel users.
36 For those of you who are running some kind of mail transport agent
37 (as Pixel is, above) or POP server, the following will show how to remove
38 it from a RedHat Linux system:
43 First cd to /etc/sysconfig.
44 As root, change (I don't recommend actively removing files
45 unless you REALLY know what you're doing) the sendmail file to
46 sendmail.old or move it from that directory completely.
48 You can either reboot or /etc/rc.d/init.d/sendmail stop, OR do a
49 ps and kill sendmail manually. Your method of choice is up to you.
53 cd /etc and edit inetd.conf. Look for a few lines similar to:
55 # Pop and imap mail services et al
57 #pop-2 stream tcp nowait root /usr/sbin/tcpd ipop2d
58 #pop-3 stream tcp nowait root /usr/sbin/tcpd ipop3d
59 #imap stream tcp nowait root /usr/sbin/tcpd imapd
62 If they're already commented out you're good to go for the
63 Citadel/UX server to take over pop. If not, you'll want to
66 2.Ensure you have the correct FQDN in (.A)ide (S)ystem (G)eneral
67 This is explained in siteconfig.txt.
68 3.Add any alias FQDN's in (.A)ide (S)ystem (I)nternet
69 Explained in inetsiteconfig.txt.
70 4.Add a Smart Host, if you need one.
71 5.Restart your Citadel/UX server.
77 FQDN: Fully Qualified Doman Name:
78 If your system were called 'test' on the foobar.com network, and you
79 had an entry on the internet by which you could get to your system
80 your FQDN would be test.foobar.com. For the most part, most FQDNs
81 will be your bbsname.citadel.org. Coordinate that with Freakdog on
82 DogpoundII (telnet://dogpound2.citadel.org).
85 Other names by which your system can be called.
88 An internet host that relays your mail for you, or a host to which
89 you would send ALL your mail which could go out via an MX record.
93 Citadel will look for an existing pop/smtp server on startup. If they don't
94 exist (and you've configured them as shown in siteconfig.txt) citadel should
95 fire them up at start time. You can check your logs to be sure, or you can
96 start the server from a shell and watch it load. It should look similar to
100 smw @ pixel % ./citserver
102 Multithreaded message server for Citadel/UX
103 Copyright (C) 1987-2000 by the Citadel/UX development team.
104 Citadel/UX is open source, covered by the GNU General Public License, and
105 you are welcome to change it and/or distribute copies of it under certain
106 conditions. There is absolutely no warranty for this software. Please
107 read the 'COPYING.txt' file for details.
109 Loading citadel.config
111 This is GDBM version 1.8.0, as of May 19, 1999.
112 Checking floor reference counts
113 Creating base rooms (if necessary)
114 Registered a new service (TCP port 504)
115 Registered a new service (TCP port 0)
116 Initializing loadable modules
117 Registered server command CHAT (Begin real-time chat)
118 Registered server command PEXP (Poll for express messages)
119 Registered server command GEXP (Get express messages)
120 Registered server command SEXP (Send an express message)
121 Registered server command DEXP (Disable express messages)
122 Registered a new session function (type 0)
123 Registered a new x-msg function (priority 0)
125 Registered a new session function (type 1)
126 Registered a new message function (type 201)
127 Registered a new message function (type 202)
128 Registered server command REGI (Enter registration info)
129 Registered server command GREG (Get registration info)
130 Registered a new user function (type 100)
132 Server-hosted upgrade level is 5.62
134 Registered server command EXPI (Expire old system objects)
135 Registered server command FSCK (Check message ref counts)
137 citserver: Can't bind: Address already in use
138 ERROR: could not bind to TCP port 25.
139 Registered a new service (TCP port 0)
140 Registered a new session function (type 50)
142 citserver: Can't bind: Address already in use
143 ERROR: could not bind to TCP port 110.
144 Registered a new session function (type 0)
146 Registered a new message function (type 202)Loaded module: $Id:
147 serv_inetcfg.c,v 1.2 2000/02/03 03:57:35 ajc Exp $
148 Registered server command RWHO (Display who is online)
149 Registered server command HCHG (Masquerade hostname)
150 Registered server command RCHG (Masquerade roomname)
151 Registered server command UCHG (Masquerade username)
152 Registered server command STEL (Enter/exit stealth mode)
155 Starting housekeeper thread
157 Notice the two error lines below:
158 citserver: Can't bind: Address already in use
159 ERROR: could not bind to TCP port 110.
161 This means that Citadel couldn't start up pop services. Generally this
162 only happens if there's something on this port. In this case it's Pixel's pop
163 server (incidentally, PixelBBS uses Citadel/UX for pop). You'll find the same
164 is true for IMAP, which runs on port 143.
166 citserver: Can't bind: Address already in use
167 ERROR: could not bind to TCP port 25.
169 This occurs whenever something is on port 25. In this case sendmail is
170 there. Make SURE you've followed the above steps to remove sendmail/pop and
171 start your server again.