Files
bongo/docs
2026-07-18 14:59:06 +02:00
..
2026-07-18 14:15:16 +02:00
2026-07-18 14:15:16 +02:00
2026-07-16 20:37:25 +02:00

Bongo documentation

This directory is the maintained documentation for the Bongo development tree. It replaces operational advice from the archived project website where paths, dependencies, security policy, or implementation status no longer match the current code.

Bongo 0.7 is still under development. A feature listed here is available in the tree, but a public server should be staged and tested before it replaces an existing mail system. The roadmap distinguishes completed, partial, and planned work.

Start here

  • Architecture describes the agents and data flow.
  • Administration covers setup, validation, services, accounts, and routine checks.
  • Directory layout lists current FHS paths.
  • Ports distinguishes public, private, and optional listeners.
  • Protocols gives the supported protocol overview.
  • Client compatibility describes realistic client expectations.
  • Storage and backup explains where mail and metadata live.
  • Development covers CMake, tests, sanitizers, and timezone maintenance.
  • Roadmap merges the useful historical 1.0 goals with the current 0.7 through 1.0 plan.

Security and mail operation

Installed manual pages document individual commands and agents. Begin with bongo-setup(1), bongo-config(1), bongo-admin(1), bongo-manager(1), and bongoagents(8).

Historical material

The archived Bongo project documentation is a provenance source for the architecture and original 1.0 product goals. The current roadmap retains goals which are still useful, including virtual domains, calendar sharing, internationalisation, administration, diagnostics, and a formal security review.

Do not use the historical site as an installation manual. Its Autotools, Python 2/mod_python, managed LDAP, filesystem, browser, and SSL instructions are obsolete. The current implementation remains a C server with a Python 3 Web interface. Experimental Ruby rewrites are not part of the product or its roadmap.