jmcgnh / homebox Goto Github PK

THIS IS A FORK. See progmaticltd/homebox for original.

A set of Ansible scripts to setup a secure email and personal files server. This project is for you if:

• You are interested to host your emails yourself, for privacy, security or any other reason.
• You want your server to be secure against both physical and remote intrusion.
• You want a low maintenance box that keep itself updated automatically.
• You trust the Debian community to publish security updates.

• Stable branch
• Development branch

Task	Development	Stable
Documentation Build
Ansible files syntax checking

For a complete list of features, see the features page in the official documentation.

• Custom Debian installer generation with full disk encryption and fully automatic installation.
• Unlock the system remotely, by entering the passphrase through SSH when the server boots, no need to keyboard / monitor.
• Install packages only from Debian stable (Stretch) or officially maintained repositories (rspamd).
• Automatic SSL Certificates generation with letsencrypt.
• Automatic security updates (optional).
• Centralised authentication with an LDAP users database, SSL certificate, password policies, PAM integration.
• AppArmor activated by default, profiles for all daemons.
• Automatic backup of the deployment data to replay the installation with the same data.
• Can be used at home, on a dedicated or virtual server hosted online.
• Flexible IP address support: IPv4, IPv6, IPv4+IPv4, IPv4+IPv6.
• Embedded DNS server, with CAA, DNSSEC and SSHFP (SSH fingerprint) support.
• Grade A https sites, HSTS implemented by default.

• Postfix configuration and installation, with LDAP lookups, internationalised email aliases, fully SSL compliant.
• Generate DKIM keys, SPF and DMARC DNS records.
• Automatic copy of sent emails into the sent folder.
• Automatic creation of the postmaster account and special email addresses using RFC 2142 specifications.
• Dovecot configuration, IMAPS, POP3S, Quotas, ManageSieve, simple spam and ham learning by moving emails in and out the Junk folder, sieve and vacation scripts.
• Virtual folders for server search: unread messages, conversations view, all messages, flagged and messages labelled as "important".
• Email addresses with recipient delimiter included, e.g. [email protected].
• Optional master user creation, e.g. for families with children or moderated communities.
• Server side full text search inside emails, attached documents and files and compressed archives, with better results than GMail.
• Optional Roundcube webmail with sieve filters management, password change form, automatic identity creation, master account access, etc.
• Optional SOGo webmail with sieve filters management, password change form, Calendar and Address book management, GUI to import other account emails.
• Automatic import emails from Google Mail, Yahoo, Outlook.com or any other standard IMAP account.
• Powerful and light antispam system with rspamd and optional access to the web interface.
• Antivirus for inbound and outbound emails with clamav.
• Automatic configuration for Thunderbird and Outlook using published XML and other clients with special DNS records (RFC 6186).

• Install and configure a CalDAV / CardDAV server, with automatic discovery (RFC 6186).
• Groupware functionality in a web interface, with SOGo.
• Recurring events, email alerts, shared address books and calendars.
• Mobile devices compatibility: Android, Apple iOS, BlackBerry 10 and Windows mobile through Microsoft ActiveSync.

• Incremental backups, encrypted, on multiple destination (SFTP, Samba share or USB drive), with email reporting. See backup documentation for details.
• Jabber server, using ejabberd, with LDAP authentication, direct or offline file transfer and optional server to server communication.
• Tor installation out of the box with possible customisation.
• Privoxy easy installation, with adblock rules daily synchronisation, and optional tor chaining.
• Embedded DNS server with DNSSEC and SSHFP (SSH fingerprint) records support
• Automatic publication of DNS entries to Gandi DNS.
• External IP address detection.
• Static web site skeleton configuration, with https certificates.
• Hugo web site server: Hugo and its numerous themes
• Personal backup server for each user, using borgbackup.
• Gogs git server, a fast and lightweight git server written in Golang.
• Transmission daemon, accessible over https, public or private over your LAN. Files can be downloaded directly with a web browser, using LDAP credentials for authentication or whitelisted IP addresses (e.g. LAN).
• Monitoring with Zabbix, with email and Jabber alerts.
• Hide the SSH server with Single Packet Authorization, using fwknop.

• YAML files validation on each commit, using travis-ci.
• End to end integration tests for the majority of components.
• Playbooks to facilitate the installation or removal of development packages.
• Global debug flag to activate the debug mode of all components.
• Fully open source Ansible scripts licensed under GPLv3.