https://github.com/corusm/server-infrastructure
This repo contains a mirror of my private server-infrastructure.
https://github.com/corusm/server-infrastructure
ansible devops docker monitoring
Last synced: 2 months ago
JSON representation
This repo contains a mirror of my private server-infrastructure.
- Host: GitHub
- URL: https://github.com/corusm/server-infrastructure
- Owner: corusm
- Created: 2022-04-05T08:13:35.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-07-11T10:05:24.000Z (almost 3 years ago)
- Last Synced: 2025-03-22T15:38:52.483Z (about 1 year ago)
- Topics: ansible, devops, docker, monitoring
- Language: Shell
- Homepage: https://leinz.dev
- Size: 4.42 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# CORUSM Docker Documentation
Hi there, this is a kind of mirror of my private docker-compose infrastructure. I'm currently moving on to `kubernetes` and wanted to make this repo public now, so others might have a more simple start to container infrastructure.
This Repo just contains a collection of public services and not my own ones.
## Provisioning
For creating the infrastructure just go to the `ansible` directory and execute `install-server.sh`. This will ask you for some inputs and will automatically setup your new VPS.
## Storage Issues
In order to keep your setup cleaned up, put this command in your CRON and run it something like once a day.
This will prevent rapidly growing storage because it will delete unused docker ressources.
```bash
docker system prune -a && docker volume prune
```
## Issues
Sometimes when I start my server, there is some instance of another server running and using an IP i've defined in Docker.
With `netset -nlp | grep 27017` you can look, which service is currently using this port and kill it.
## Monitoring
For Monitoring I use a `Grafana`, `Prometheus`, `Loki` and `Watchtower` Stack.
Grafana and Prometheus are used for Metrics and Loki is the logging server/database.
### Watchtower
[Watchtower](https://containrrr.dev/watchtower/) is a service, that checks in defined intervals if there is any update for the container image.
If there is one, it will pull the update and restart the container. You wont must make updates manually again.
Add following label to your containers, that you want to get updated by watchtower. Some services will break when doing this (f.e. Mailcow).
```yml
label:
- com.centurylinklabs.watchtower.enable="true"
```
## Loki
In order to sent logs to Loki you first need to install the loki logging driver.
```bash
docker plugin install grafana/loki-docker-driver:latest --alias loki --grant-all-permissions
```
If installed add this config to your `docker-compose` file.
```yml
x-logging:
&default-logging
driver: loki
options:
mode: non-blocking
loki-url: http://localhost:3100/loki/api/v1/push
loki-external-labels: host=corusm.de,stack=keila
```
To your service you must then add `logging: *default-logging`.
# Backups
For backups I use `rclone` which is similar to `rsync` but different. `rclone` can `rsync` files to your cloud provider. So via `rsync` links I copy these files in my cloud.
# Reverse Proxy
As a reverse proxy I use traefik, which does the whole certificate stuff for me. Configs are visible in my docker-compose files.
In order to get this repo to work for you, you must change my domain to yours.
# Service Overview
| Service | Description |
|--------------------|-----------------------------------------------------------------------------------|
| Mailcow-Dockerized | Self-Hosted E-Mail Server |
| Bitwarden | Self-Hosted Password Manager |
| Keila | Open-Source Newsletter Tool |
| LogSeq | A privacy-first, open-source platform for knowledge management and collaboration. |
| Mattermost | Open-Source Slack Alternative |
| Metrics | Grafana, Prometheus, Loki Stack |
| MLFlow | Machine-Learning Dev-Ops Tool |
| Shlink | Self-Hosted Bit.ly alternative |
| Vault | Harshicorp Vault for Secret Management |
| Wireguard | Self-Hosted VPN Tunnel |
| Registry | Self-Hosted Docker-Registry |
| Jenkins | Open-Source CI/CD Tool |
| Code-Server | VSCode in the Web |
| Gotify | Self-Hosted Notification Server |
| Jupiter-Notebook | Jupiter Notebook Server |
| LanguageTool | Open-Source Grammerly Alternative |
| Nextcloud | Self-Hosted Cloud (Calendar, Docs, Files) |
| Penpot | Prototyping Tool (Figma Alternative) |
| Radicale | Self-Hosted CalDav/CardDav (Calendar and Contacts) |
| Sharelatex | Self-Hosted Overleaf Server |
| Traefik | Reverse Proxy Service |
| Watchtower | Automated Container Updates |
| FreshRSS | RSS Reader |