ssoma - some sort of mail archiver ---------------------------------- ssoma is a git-based mail archiver and transport. Email is injected via ssoma-mda(1) (MDA: mail delivery agent) on a server and may be shared (via git) and extracted to mbox, Maildir, or IMAP via ssoma(1). ssoma exists primarily as the mechanism (not policy) for public-inbox but may easily be used for other projects. Readers of public-inbox instances may install ssoma to extract messages into their favorite mail client for reading. See http://public-inbox.org/ for more information on how ssoma is used. Features -------- * stores email in git, so readers have a full history of the mailing list * mail user-agent (MUA) users may choose from IMAP, mbox(5), and Maildir * uses only well-documented and easy-to-implement data formats Install ------- Installation should be easy and require only a few, commonly-available packages. See http://ssoma.public-inbox.org/INSTALL for details. Hacking ------- Source code is available via git: git clone git://80x24.org/ssoma See below for contact info. Contact ------- We are happy to see feedback of all types via plain-text email. Please email comments, user/developer discussion, patches, bug reports, and pull requests to the public-inbox discussion list at: firstname.lastname@example.org Please Cc: all recipients when replying (this is not a requirement of public-inbox or ssoma, but a good idea since we do not require subscription). This also makes it easier to rope in folks of tangentially related projects we depend on (e.g. git developers on email@example.com). You can subscribe via ssoma, LISTNAME is a name of your choosing: URL=git://public-inbox.org/meta LISTNAME=public-inbox # to initialize a maildir (this may be a new or existing maildir, # ssoma will not touch existing messages) # If you prefer mbox, use mbox:/path/to/mbox as the last argument ssoma add $LISTNAME $URL maildir:/path/to/maildir # read with your favorite MUA (only using mutt as an example) mutt -f /path/to/maildir # (or /path/to/mbox) # to keep your mbox or maildir up-to-date, periodically run the following: ssoma sync $LISTNAME # your MUA may modify and delete messages from the maildir or mbox, # this does not affect ssoma functionality at all # to sync all your ssoma subscriptions ssoma sync # You may wish to sync in your cronjob ssoma sync --cron Mail repository format ---------------------- If you are uncomfortable running code in ssoma for any reason and would rather read directly from the git repository, the following document describes it: http://ssoma.public-inbox.org/ssoma_repository.txt Copyright --------- Copyright 2013-2016 all contributors <firstname.lastname@example.org> License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt> This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program. If not, see <http://www.gnu.org/licenses/>. Additional permission under GNU GPL version 3 section 7: If you modify this program, or any covered work, by linking or combining it with the OpenSSL project's OpenSSL library (or a modified version of that library), containing parts covered by the terms of the OpenSSL or SSLeay licenses, the copyright holder(s) grants you additional permission to convey the resulting work. Corresponding Source for a non-source form of such a combination shall include the source code for the parts of OpenSSL used as well as that of the covered work.