0. Überblick
- Verwendetes System: Debian 11 64 bit - VPS XXL 2.0
- Genutzter User: Ich nehme alles als „root“ vor
- Zeitdauer: ca. 10 Minuten
- Schwierigkeit: Einfach. Nur Code kopieren 😉
- Besonderheiten:
- Grundlage ist folgende Anleitung: https://www.dogado.de/vps/vserver-anwendungsfaelle/traefik-reverseproxy-auf-vserver-installieren. Diese Anleitung muss zuerst ausgeführt werden.
- Die Installation von Docker / Docker Compose wird hier vorausgesetzt.
1. Diaspora installieren
1.1 Einleitung
Diaspora ist ein freies, offenes soziales Netzwerk. Im Gegensatz zu anderen bekannten großen sozialen Netzwerken, ist Diaspora als dezentrales, verteiltes System aufgebaut.
1.2 Infos zu yml Dateien
Bei yml Dateien ist es sehr wichtig, dass die Zeilen alle richtig eingerückt sind. Die Zeilen MÜSSEN immer mit der Leertaste eingerückt werden. Es dürfen KEINE Tabs enthalten sein. Du kannst den nachfolgenden Code immer online „überprüfen“ lassen. Die meisten Fehler entstehen nämlich durch die falsche Formatierung. Ein Dienst zum Überprüfen ist zum Beispiel: https://codebeautify.org/yaml-validator
1.3 Vorbereitung
Diese Anleitung basiert auf dem aktuellen Debian 11 Betriebssystem. Diaspora werden wir unter Docker realisieren. Dies ermöglicht uns später sehr schnelle Updates und eine schnelle Installation.
Um Diaspora neben anderen Diensten auf unserem Server betreiben zu können, nutzen wir hier den Reverse Proxy Traefik. Die Anleitung dazu findest du hier: https://www.dogado.de/vps/vserver-anwendungsfaelle/traefik-reverseproxy-auf-vserver-installieren
Diese Anleitung passt auf die obige Traefik Anleitung. Daher lässt sich diese Anleitung nur 1:1 nutzen, wenn du Traefik nach der obigen Anleitung installiert hat.
1.3.1 Verzeichnis anlegen
Zuerst legen wir uns ein Verzeichnis an, in welchem wir später alle Daten von Diaspora speichern wollen.
mkdir -p /opt/containers/diaspora
Den Pfad kannst du gerne anpassen. Dann kannst du diese Anleitung aber nicht mehr 1:1 nutzen.
1.3.2 Docker Compose Datei erstellen
Nun legen wir uns noch eine Docker Compose Datei an. Diese ist der „Bauplan“ für Diaspora. Dazu gibst du folgendes in der Konsole ein:
nano /opt/containers/diaspora/docker-compose.yml
Nun kopierst du folgenden Inhalt:
version: '3'
services:
diaspora:
image: koehn/diaspora:0.7.17.0
container_name: diaspora
restart: unless-stopped
volumes:
- ./images:/home/diaspora/diaspora/public/uploads/images
- ./diaspora.yml:/home/diaspora/diaspora/config/diaspora.yml:ro
- ./database.yml:/home/diaspora/diaspora/config/database.yml:ro
labels:
- "traefik.enable=true"
- "traefik.http.routers.diaspora.entrypoints=http"
- "traefik.http.routers.diaspora.rule=Host(`diaspora.euredomain.de`)" # Hier eure URL eingeben #
- "traefik.http.middlewares.diaspora-https-redirect.redirectscheme.scheme=https"
- "traefik.http.routers.diaspora.middlewares=diaspora-https-redirect"
- "traefik.http.routers.diaspora-secure.entrypoints=https"
- "traefik.http.routers.diaspora-secure.rule=Host(`diaspora.euredomain.de`)" # Hier eure URL eingeben #
- "traefik.http.routers.diaspora-secure.tls=true"
- "traefik.http.routers.diaspora-secure.tls.certresolver=http"
- "traefik.http.routers.diaspora-secure.service=diaspora"
- "traefik.http.services.diaspora.loadbalancer.server.port=3000"
- "traefik.docker.network=proxy"
- "traefik.http.routers.diaspora-secure.middlewares=secHeaders@file"
networks:
- proxy
- default
postgres:
image: postgres:10-alpine
container_name: diaspora-db
restart: unless-stopped
environment:
- POSTGRES_USER=diaspora
- POSTGRES_PASSWORD=diaspora
- POSTGRES_DB=diaspora_production
volumes:
- ./postgres:/var/lib/postgresql/data
- ./postgres-run:/var/run/postgresql
networks:
- default
redis:
image: redis:latest
container_name: diaspora-redis
restart: unless-stopped
command: redis-server --appendonly yes
volumes:
- ./redis:/data
networks:
- default
networks:
proxy:
external: true
Nun müssen wir noch einiges anpassen.
1.3.3 Hostname anpassen
Zuerst musst du noch den Hostnamen anpassen, über welchen später Diaspora erreichbar sein soll.
Diese beiden Zeilen musst du anpassen.
- "traefik.http.routers.diaspora.rule=Host(`diaspora.euredomain.de`)"
- "traefik.http.routers.diaspora-secure.rule=Host(`diaspora.euredomain.de`)"
In meinem Fall also:
- "traefik.http.routers.diaspora.rule=Host(`diaspora.testbereich.net`)"
- "traefik.http.routers.diaspora-secure.rule=Host(`diaspora.testbereich.net`)"
1.3.4 Postgres Passwort anpassen
Hier musst du lediglich folgende Zeile anpassen. Setze ein sicheres Passwort deiner Wahl.
vorher:
- POSTGRES_PASSWORD=diaspora
nachher:
- POSTGRES_PASSWORD=Ad123Dd21uf3
1.3.5 Verbindung zur Datenbank herstellen
Um die Verbindung zur Datenbank herzustellen, benötigen wir noch eine Konfigurationsdatei. Diese erstellen wir nun. Dazu gibst du folgendes ein:
nano /opt/containers/diaspora/database.yml
Hier kopierst du nun folgendes hinein:
postgresql: &postgresql
adapter: postgresql
host: diaspora-db
port: 5432
username: diaspora
password: diaspora
encoding: unicode
mysql: &mysql
adapter: mysql2
host: "localhost"
port: 3306
username: "root"
password: ""
# socket: /tmp/mysql.sock
encoding: utf8mb4
collation: utf8mb4_bin
# Comment the postgresql line and uncomment the mysql line
# if you want to use mysql
common: &common
# Choose one of the following
<<: *postgresql
#<<: *mysql
# Should match environment.sidekiq.concurrency
#pool: 25
##################################################
#### CONFIGURE ABOVE #############################
##################################################
# Normally you don't need to touch anything here
combined: &combined
<<: *common
development:
<<: *combined
database: diaspora_development
production:
<<: *combined
database: diaspora_production
test:
<<: *combined
database: "diaspora_test"
integration1:
<<: *combined
database: diaspora_integration1
integration2:
<<: *combined
database: diaspora_integration2
Nun müssen wir noch das Kennwort ändern. Hier musst du das selbe Passwort verwenden, welches du in Schritt 1.3.4 vergeben hast.
vorher:
password: diaspora
nachher:
password: Ad123Dd21uf3
1.3.6 Diaspora Konfiguration erstellen
Diaspora wird zum großen Teil per Konfigurationsdatei konfiguriert. Da die Konfigurationsdatei sehr groß ist, laden wir uns hier eine Beispiel-Konfiguration herunter, welche wir später anpassen werden.
Zum Download gibst du folgendes ein:
wget https://raw.githubusercontent.com/psaxton/docker-koehn-diaspora/master/compose/diaspora.yml.example
Nun benennen wir die Datei noch um. Dazu gibst du folgendes ein:
mv diaspora.yml.example diaspora.yml
Diese Datei passen wir nun an. Dazu gibst du folgendes ein:
nano /opt/containers/diaspora/diaspora.yml
Hier musst du direkt oben in der Datei folgendes ändern:
vorher:
# url: "https://example.org/"
redis: 'redis://redis'
nachher:
url: "https://diaspora.testbereich.net"
redis: 'redis://diaspora-redis'
So sieht es bei mir aus:
Nun scrollst du bis zum Bereich „assets“. Hier änderst du folgendes ab:
vorher:
# serve: false
nachher:
serve: true
Dies sollte so aussehen:
Das sind die wichtigsten Einstellungen, damit du Diaspora später nutzen kannst. In der Konfiguration gibt es aber noch sehr viele andere Einstellungen, welche du nach Bedarf anpassen kannst.
2. Diaspora starten
Nun kannst du Diaspora starten. Dazu gibst du folgendes ein:
docker compose -f /opt/containers/diaspora/docker-compose.yml up -d Nach einigen Minuten sollte Diaspora im Browser zur Verfügung stehen. Dazu gehst du auf die Domain, welche du in der Docker Compose Konfiguration eingegeben hast. Bei mir ist dies: https://diaspora.testbereich.net
Jetzt solltest du folgendes sehen:
2.1 Administrator anlegen
Dazu müssen wir uns zuerst einen „normalen“ Benutzer anlegen. Diesen können wir dann zum Administrator machen.
Den neuen Benutzer legst du an, indem du oben rechts auf „Konto erstellen“ klickst.
Nun siehst du folgende Webseite. Hier erstellst du nun deinen neuen Benutzer.
Wenn der Benutzer erstellt wurde, solltest du folgendes sehen:
Nun können wir Benutzer zum Administrator machen. Wichtig dabei ist, dass der Diaspora Container gestartet ist.
Du gibst folgendes in deiner Konsole ein:
docker exec -it diaspora /bin/bash
cd diaspora/
RAILS_ENV=production bundle exec rails console Hier musst du nun deinen Nutzernamen anpassen:
Role.add_admin User.where(username: "<Nutzername>").first.person
Mein Benutzer heißt „dogado“. Also sieht die Zeile bei mir so aus:
Role.add_admin User.where(username: "dogado").first.person
Wenn alles funktioniert hat, solltest du folgendes sehen:
Nun kannst du deinen Container mit folgendem Befehl wieder verlassen
exit
exit
Hier alle Befehle auf einen Blick
Nachdem du dich bei Diaspora neu angemeldet hast, solltest du oben rechts unter deinem Namen den Reiter „Admin“ sehen.
Mit einem Klick darauf kommst du ins Admin Interface.
