97 lines
4.3 KiB
Markdown
97 lines
4.3 KiB
Markdown
# THIS PROJECT HAS MOVED
|
|
https://github.com/equalitie/dcomms-docker-compose
|
|
|
|
# dcomms
|
|
|
|
Decentralized communications that work with or without the Internet
|
|
|
|
# Prerequisites
|
|
* `docker` using the docker guide (https://docs.docker.com/engine/install/)
|
|
* `curl`, `aria2`, `tor`
|
|
* A directory named `/var/www/dcomms` created on the host for the website document root.
|
|
* A subdomain with the A record pointed to the IP address of a node for automatic issuance of a Let's Encrypt SSL certificate.
|
|
* A subdomain with the MX record pointed to the A record of a node for DeltaChat mail delivery.
|
|
* (Optional) A Tor hidden service [configured](https://community.torproject.org/onion-services/setup/), and listening on port 80 and 8448.
|
|
|
|
# Introduction
|
|
|
|
`dcomms` is a bundle of decentralized communication software running as services in the form of a docker swarm stack.
|
|
|
|
It is used to rapidly deploy a server hosting a variety of decentralized, encrypted, and federated communications platforms such as [Matrix](https://matrix.org/) and [DeltaChat](https://delta.chat) across multiple hosts.
|
|
|
|
Let's Encrypt TLS certificates are automatically issued and managed by the Caddy container across all services.
|
|
|
|
## Service containers
|
|
|
|
The dcomms stack leverages single node, non-replicated containers of the following services built from the latest images below:
|
|
|
|
* [CENO client](https://hub.docker.com/r/equalitie/ceno-client) courtesy of censorship.no
|
|
* [Synapse Docker](https://hub.docker.com/r/matrixdotorg/synapse/) courtesy of matrix.org
|
|
* [Element](https://hub.docker.com/r/vectorim/element-web/) courtesy of vector-im
|
|
* [Mau](https://mau.dev/maubot/maubot) courtesy of the maubot dev team
|
|
* [Caddy](https://hub.docker.com/_/caddy) courtesy of the Caddy Docker Maintainers
|
|
* [docker-mailadm](https://github.com/deltachat/docker-mailadm), includes dovecot and postfix, courtesy of DeltaChat
|
|
* [Mastodon](https://hub.docker.com/r/aphick/mastodon-sendmail), a modified version of the original Mastodon [container](https://hub.docker.com/r/tootsuite/mastodon) that includes sendmail.
|
|
|
|
## Ports
|
|
|
|
CENO client: 28729/udp \
|
|
Caddy (webserver): 443/tcp, 80/tcp, 8448/tcp \
|
|
DeltaChat (postfix/dovecot): 587/tcp 143/tcp
|
|
|
|
* Note: `dcomms` leverages docker host networking and therefore we recommend denying access to all other unnecessary ports at the host level.
|
|
|
|
# Installation
|
|
|
|
Point the following A records to the docker worker you wish to use for deployment:
|
|
```
|
|
matrix.server1.example.org -> IP of your server
|
|
chat.server1.example.org -> IP of your server
|
|
server1.example.org -> IP of your server
|
|
```
|
|
|
|
Point the following MX record to the A record:
|
|
```
|
|
server1.example.org -> server1.example.org
|
|
```
|
|
|
|
Clone or download this repository. Review `./install.sh` and make any that may be required for your environment.
|
|
|
|
|
|
## Install
|
|
|
|
Once your server meets the prerequisites, installation simply involves running `./install.sh` and responding to any prompts. Configs will be automatically placed in your `DCOMMS_DIR` and a `run.sh` script will be generated.
|
|
|
|
* Note: If you wish to reinstall dcomms you will need to delete all docker volumes, and the `conf` directory in `DCOMMS_DIR` before running `install.sh` again.
|
|
|
|
## Redeploy
|
|
|
|
In the future, if you need to start the dcomms containers again simply run the `./run.sh` program in your `DCOMMS_DIR`.
|
|
|
|
# Tor
|
|
|
|
If you wish to provide users with a Tor hidden service address by which they can access your services, you must first install and [configure Tor](https://community.torproject.org/onion-services/setup/).
|
|
The script will detect if you have Tor installed and prompt you for a hidden service address. You can find this in the `hostname` file in your `HiddenServiceDir`.
|
|
|
|
Example:
|
|
```
|
|
cat /var/lib/tor/onion_service/hostname
|
|
```
|
|
|
|
# Post installation
|
|
|
|
* Copy a pre-existing website into `/var/www/dcomms/` across all docker nodes or checkout all files from either the [dcomms-web repo (UA)](https://github.com/censorship-no/dcomms-web) or the [chatv3 repo (RU)](https://github.com/censorship-no/chatv3-web) into the same location.
|
|
* Optionally visit `https://server1.example.org` to view the website.
|
|
* Optionally visit `https://chat.server1.example.org` to view the Element service.
|
|
* Optionally configure a Matrix client to use `https://matrix.server1.example.org` as the homeserver.
|
|
|
|
|
|
# Troubleshooting
|
|
|
|
## Log review
|
|
|
|
## Altering configs
|
|
|
|
## Specific issues with services
|
|
|