documentation
[citadel.git] / citadel / docs / macintosh-readme.txt
1 Updated install instructions for Citadel and Webcit 7.37 (28/10/2008):
2 External libraries:
3 1. libsieve
4 Some patches need to be applied to the libsieve to make it compile. You can
5 get these from MacPorts:
6 http://trac.macports.org/browser/trunk/dports/mail/libsieve/
7 2. gettext
8 You will need to install gettext and add "-lintl" to LIBS in webcit's makefile
9 to make that compile
10 http://ftp.gnu.org/pub/gnu/gettext/
11
12 Older instructions from 10.4 era (2005):
13 Theres only a brief bit on OS X in the docs but to save some people time
14 perhaps this can be noted somewhere:
15
16 All instructions here assume 10.4 (Tiger). Note gcc package difference
17 for earlier versions.
18
19 The easiest way to get Berkeley DB installed is downloading them via
20 Fink ( http://fink.sourceforge.net ). Install db42 via apt-get .
21 Apparently OS X Server installs already have Berkeley DB.
22
23 If you haven't got them already, gcc4.0.pkg, Xcode Tools.mpkg,
24 DeveloperTools.pkg and SDK.pkg from Xcode need to be installed to
25 compile (plain old boring Darwin users should already have all of them).
26 Remember to export CC=gcc-4.0 as gcc isn't symlinked by default.
27
28 libical and webcit install fine, but you need some configure arguments
29 for citadel itself:
30 ./configure --disable-autologin --with-db=/sw/
31 (--disable-autologin must be there otherwise accounts with the same name
32 as system users won't work! I just spent half an hour bashing my head on
33 this!)
34
35 If you didn't grab Berkeley DB from Fink, substitute your own path for
36 --with-db.
37
38 Ignore what the setup script says about Citadel failing to start, start
39 it yourself afterwards.
40
41 I'm not sure if inittab does anything on OS X / Darwin (AFAIK Apple
42 doesn't really want us to use it), so you can create your own startup
43 scripts in /Library/StartupItems/. See
44 http://www.opendarwin.org/en/articles/system_starter_howto/
45
46 Webcit works fine, seems to lock up if you try adding new Internet
47 domains though, add them via the citadel client itself.
48
49 Other than that: Webcit looks better than it was from when I last used
50 it 6 months ago :-)
51
52 - Mathew McBride
53