self-hosted-services

This repository contains everything you need to start self-hosting a core set of privacy-preserving services that I have found helpful, all run via a common Docker Compose configuration using Let's Encrypt for SSL certificates.

Requirements

• Git
• Docker Engine
• Docker Compose
• Ports 80/tcp, 443/tcp, 18080/tcp, 18083/tcp, 3333/tcp, 37889/tcp, and 18089/tcp exposed/forwarded to the host
• DNS entries for your top-level domain and each desired sub-domain

Included Services

• Nextcloud
  • A self-hosted server for hosting files, photos, backups, contacts, calendars, and much more
• Uptime-kuma
  • It is a self-hosted monitoring tool like "Uptime Robot"
• Libretranslate
  • Free and Open Source Machine Translation API, entirely self-hosted
• SearXNG
  • a privacy-respecting, hackable metasearch engine
• Send
  • a fork of Mozillas's Firefox Send, which was an encrypted file sharing tool
• Wordpress
  • WordPress is a free and open-source content management system (Website Builder)
• Cryptpad
  • CryptPad is a collaboration suite that is end-to-end-encrypted and open-source
• P2Pool
  • Decentralized pool for Monero mining
• Invidious
  • Invidious is an alternative front-end to YouTube
• Monero
  • A self-sovereign, private-by-default, digital cash
  • This service runs a pruned Monero node, allowing you to connect your own Monero wallet(s) directly to your own node
• Nitter
  • A privacy-preserving Twitter front-end
• PrivateBin
  • A privacy-preserving and encrypted-by-default pastebin
• Teddit
  • A privacy-preserving Reddit front-end
• Wallabag
  • A privacy-preserving article reader in the vein of Pocket
• Monero blockchain explorer
  • A self-hosted Monero blockchain explorer
• Conduit
  • A self-hosted Matrix homeserver written in Rust
• Jellyfin
  • A software media system with no strings attached, no premium licenses or features, and no hidden agendas

NOTE: If you do not want to run one of the services above simply comment out or delete the relevant service section from docker-compose.yml.

How does it work?

This repo relies on Docker Compose to configure and run all of the above services, leveraging Traefik to automatically expose each service, request and maintain Let's Encrypt certificates for SSL, and handle all proxying.

Starting the Services

You will need to clone this repository to the host you want running these services first:

git clone https://github.com/sethforprivacy/self-hosted-services.git
cd self-hosted-services

Once cloned, set the necessary passwords and desired sub-domains in the .env file (PLEASE DO NOT COPY THE FOLLOWING CONFIG, CHANGE THE PASSWORDS AND HOSTNAMES APPROPRIATELY IN YOUR LOCAL .env FILE):

# Nextcloud Variables
NEXTCLOUD_HOSTNAME=nextcloud.mydomain.com
NEXTCLOUD_ADMIN_USER=
NEXTCLOUD_ADMIN_PASSWORD=
POSTGRES_PASSWORD=

# Wallabag Variables
WALLABAG_HOSTNAME=wallabag.mydomain.com
WALLABAG_DB_ROOT_PASS=
WALLABAG_DB_PASS=
WALLABAG_URL=https://wallabag.mydomain.com

# Teddit Variables
TEDDIT_HOSTNAME=teddit.mydomain.com

# Nitter Variables
NITTER_HOSTNAME=nitter.mydomain.com

# Traefik Variables
TRAEFIK_HOSTNAME=traefik.mydomain.com

# Heimdall Variables
DASHBOARD_HOSTNAME=dashboard.mydomain.com
DASHBOARD_TZ=America/New York

# Privatebin Variables
PRIVATEBIN_HOSTNAME=paste.mydomain.com

# Monero explorer variables
EXPLORER_HOSTNAME=explorer.mydomain.com

# Let's Encrypt Variables
LE_EMAIL_ADDRESS[email protected]

Note that all hostnames used must already have DNS entries configured with your domain provider in order for certificate generation to function properly.

Edit the Nitter configuration file:

• Nitter

  • Replace the hostname, replaceTwitter, and replaceYouTube values with the relevant hostnames

• SearXNG

  • Generate MORTY_KEY sed -i "s|ReplaceWithARealKey\!|$(openssl rand -base64 33)|g" settings.yml .env
  • go into the settings.yml file and replace the searx.mydomain.com at the bottom of the file with your domain.

• P2Pool

  • Hugepages are very important for optimal mining performance. You need to enable them first using the following commands:

sudo sysctl vm.nr_hugepages=3072
sudo bash -c "echo vm.nr_hugepages=3072 >> /etc/sysctl.conf"

Note: If your VPS or Server does not have enough RAM you can reduce it by using 1168 instead of 3072

• Conduit
  • Start by planning out your setup. If you are willing to dedicate the domain you want to use as the handle:
  • @user:domain.tld, then just set that in Conduit_Hostname in .env and in conduit/wellknown.conf as the whole . part
  • If you wish to have a website, or other stuff on that domain instead, then you will need to dive-in some way or another.
  • Let's say you're okay with having the handle look like @user:subdomain.domain.tld, then just set that in the files mentioned above.
  • If you wish, to have the domain in the handle, and in use at the same time, you will need to dive into the docker-compose.yml itself
  • and set the line with comment: #Change to root domain if desired to the root domain, otherwise keep the subdomain everywhere else
  • Set up redirect on the route https://domain.tld/.well-known/matrix/* to https://subdomain.domain.tld/.well-known/matrix/:splat
  • At least this setup was tested. Feel free to come up with easier ways to this setup.
  • Otherwise if you get stuck, leave an issue, someone will surely help out.

Start-up the services with Docker Compose:

• docker-compose up -d

Tor Support

Currently Monero, P2Pool, Nitter, SearXNG, Invidious, Libretranslate, and Teddit get default Tor support, but I will likely expand that in the future. To list Onion services, simply run:

• docker exec -ti tor onions

Updates

Automatic updates are provided by the Watchtower container that watches and updates base images of services when available. It will automatically search for, download, and migrate your services to updated images whenever available.

Logging

If you find yourself in need of viewing logs for a given service, simply run the following to tail all logs:

docker-compose logs --follow

To view the logs of a single service, run:

docker-compose logs --follow <service_name>

i.e.:

docker-compose logs --follow monerod

Getting Started

As this simply helps you get these services running, using each service is outside of the scope of this project. However, below are some links for getting started with each:

• Nextcloud
• Monero
• Nitter
• PrivateBin
• Teddit
• Wallabag
• Invidious
• P2Pool
• CryptPad
• WordPress
• Send
• Uptime-kuma
• SearXNG
• Libretranslate
• Conduit
• Jellyfin

Donations

If you decide to run this and use these services, please don't forget to donate to those people making these services a reality!

• Monero
• Nitter
• Teddit
• Wallabag
• Invidious
• P2Pool
• CryptPad
• WordPress
• Uptime-kuma
• SearXNG
• Conduit
• Jellyfin

Additional Resources

• Docker Compose documentation

Additional Credits

• https://github.com/cmehay/docker-tor-hidden-service
  • This Docker container makes it incredibly easy to expose Tor Hidden Services of other running containers
• https://github.com/containrrr/watchtower
  • Watchtower automates updating base images for other running containers