Source code

Please be aware that Citadel now uses a “rolling release” model. The download links on this page are the newest, freshest source code images we have released. But for packagers and others who want filenames with version numbers and dates to track, you can look at http://easyinstall.citadel.org/manifest.html.

Required dependencies

The Citadel system relies on the following libraries in order to provide its full set of functionality. (If you are using pre-built packages, or the Easy Install system, these libraries will be brought in for you automatically.)

• Berkeley DB is used as the system's primary data store
• libical for calendar services
• The Expat XML parser to handle RSS feeds, Jabber/XMPP service, etc.
• libcurl for protocol support
• OpenSSL for >SSL/TLS encrypted protocols

libcitadel

http://easyinstall.citadel.org/libcitadel.tar.gz

libcitadel contains common code which is shared across all of the components which make up the Citadel system. Its installation is mandatory. Please install it first. (If you are using pre-built packages, or the Easy Install system, this library will be brought in for you.)

Citadel Server

http://easyinstall.citadel.org/citadel.tar.gz

This is the most recent stable version of Citadel Server. This version is known to work on recent versions of Linux, FreeBSD and Solaris; it should work on other systems as well. See howto compile against EasyInstall in case of you wanting to temporarily replace your citserver.

WebCit

http://easyinstall.citadel.org/webcit.tar.gz

WebCit provides an elegant, modern web user interface to Citadel, allowing users to access (and privileged users to administer) the system from any web browser. It also allows GroupDAV and Webcal (DAV) clients to connect. WebCit is installed in addition to a working Citadel server; it will not run by itself and it will not run over a non-Citadel server. In almost all cases you will want to run both services (although you can run them on different hosts if you want to).

Text mode client

http://easyinstall.citadel.org/textclient.tar.gz

This optional component provides a Citadel client that runs in a terminal window, exposing a user interface crafted in the style of a Bulletin Board System (BBS).

Included Third Party Dependencies

Several components from the open source community are delivered with Citadel.

1. [webcit] prototype for asynchronous http requests
2. [webcit] scriptaculous
3. [webcit] the choice for rich text editing
4. [webcit] Fine Uploader for file uploads
5. [webcit] DatePicker for easy editing of timestamps
6. [webcit] Nano Tree for the rooms tree view
7. [libcitadel] ZLib for compression
8. [libcitadel] XDG-Mime to determine the types of files.
9. [libcitadel] lookup3 for hashing strings

Third-party contributions

Here are add-ons and other programs provided by Citadel users.

• Citadel client library for Perl programs by Robert Barta.
• Cron Calendar Paging
• http://sourceforge.net/projects/modauthcitadel contributed by Stuart Cianos.
• SELinux integration for the Citadel Services: http://sourceforge.net/projects/citadelselinux/ contributed by Stuart Cianos
• Warren
• Python Citadel Client by dugres
• Citadel Sync by TaMeR synchronizes local files (contacts, notes, calendar items, tasks, text) with a Citadel account. https://bitbucket.org/gotamer/citadel/wiki/CitadelSync
• Citadel Go Client by TaMeR is a library to access Citadel email and collaboration servers from Go using the Citadel Protocol. https://bitbucket.org/gotamer/citadel
• Citadel https://bitbucket.org/robotamer/citadelphp

Source code repository (git)

Developers can also download the current development sources from the repository. If you intend to do development work on the Citadel code then you should work with this version, but do not attempt to run a production system on unreleased code.

• GitWeb: https://code.citadel.org/?p=citadel.git
• Git repository URL: https://code.citadel.org/git/citadel.git