Adhocratie is a powerful and modern solution for managing businesses & team collaboration. It is released under AGPL 3.0 License and open to contributions.
The project aims to provide people with an easily setup, easily maintained, integrated and full-featured collaboration platform. It is designed to be a full-featured enterprise-grade solution. For the time, it ships :
All these components are strongly integrated, you can for example :
You will need to choose a master domain for you platform. It can be an organization domain (example: mycompany.com).
This choice is important because :
Any distribution that could run Docker and Docker-compose. This tutorial will cover a Debian based distribution case, but apart from Docker and Docker-compose installation, all steps remain the same for all distributions.
The minimal requirements for that server are :
The server can be deployed in closed network, services will be reached only from within the network. You must therefore set up a route to enable outgoging SMTP (if email server features are used).
You will need to setup some DNS entries to make Adhocratie services reachable.
Host | Record Type | Mandatory | Value |
---|---|---|---|
mail.masterdomain | A/CNAME | ✓ | IP/FQDN of your server |
auth.masterdomain | A/CNAME | ✓ | IP/FQDN of your server |
autodiscover.masterdomain | A/CNAME | Exchange ActiveSync Gateway | IP/FQDN of your server |
cnf.masterdomain | A/CNAME | ✓ | IP/FQDN of your server |
coz.masterdomain | A/CNAME | ✓ | IP/FQDN of your server |
imap.masterdomain | A/CNAME | Used for better email client autodiscover | IP/FQDN of your server |
kan.masterdomain | A/CNAME | ✓ | IP/FQDN of your server |
manage.masterdomain | A/CNAME | ✓ | IP/FQDN of your server |
mel.masterdomain | A/CNAME | ✓ | IP/FQDN of your server |
pop.masterdomain | A/CNAME | Used for better email client autodiscover | IP/FQDN of your server |
scrumblr.masterdomain | A/CNAME | ✓ | IP/FQDN of your server |
smtp.masterdomain | A/CNAME | Used for better email client autodiscover | IP/FQDN of your server |
tab.masterdomain | A/CNAME | ✓ | IP/FQDN of your server |
viz.masterdomain | A/CNAME | ✓ | IP/FQDN of your server |
wik.masterdomain | A/CNAME | ✓ | IP/FQDN of your server |
s3.masterdomain | A/CNAME | ✓ | IP/FQDN of your server |
The following DNS entries can be set AFTER the server deployment since DKIM keys are generated on the fly.
These entries are related to mail server features, you won’t need them if you don’t use mail.
Host | Record Type | Value | Priority |
---|---|---|---|
masterdomain | MX | IP/FQDN of your server | 10 |
masterdomain | TXT | v=spf1 mx a:mail.masterdomain -all | |
dkim._domainkey.masterdomain | TXT | Retreive from Manage UI | |
_dmarc.masterdomain | TXT | Retreive from Manage UI |
You will need a Wildcard certificate for your masterdomain. You can order one from an SSL provider (recommended for production) or use a Let's Encrypt one.
This is an Wildcard request example using certbot :
certbot certonly \
--server https://acme-v02.api.letsencrypt.org/directory \
--manual \
-d '*.mycompany.com' \
--preferred-challenges dns
Prepare a Shell on your target server and do the following.
➡️ Install Docker and Docker-compose
Some links to help you :
➡️ Disable any SMTP server on the host (it may conficts with Mailu)
# Example for exim4
systemctl stop exim4
systemctl disable exim4
➡️ Clone adh-compose Git repository
git clone https://github.com/adhocratie/adho-compose.git
➡️ Generate the configuration
The config.yml
file contains all necessary configuration to setup you Adhocratie platform. Most parameters are commented and/or straight forward.
platform.domain
and all related platform params.You can then generate the configuration using :
cd adh-compose.git
./gen_conf
➡️ Deploy your domain Wildcard certificate
Put your domain wildcard certificate files under ssl directory.
ssl
├── cert.pem -> Your domain wildcard certificate (fullchain)
├── key.pem -> Associated private key
└── PLACEHOLDER
➡️ Run deployment
./deploy
➡️ Create an administrator account
docker-compose run sanji /scripts/add_admin_user John Doe [email protected]
➡️ Connect to Manage UI & finish your administrator account configuration
Simply connect to https://manage.platformdomainx
and follow the account configuration wizard.
➡️ Goto Team section in the manage UI & finish the platform configuration
Goto the Team Section and make sure to update :
Adhocratie is powerful, yet it is Open. So start using it and talking about it. We have a very low marketing budget, we count on you to spread the good word.