MSK Paste selbst hosten

Diese Anleitung führt dich durch die Installation von MSK Paste auf deinem eigenen Debian- oder Ubuntu-Server. Willst du einfach die gehostete Instanz nutzen, geh direkt zu paste.msk-scripts.de, dort ist nichts einzurichten.

---

Voraussetzungen

Komponente	Mindestversion
Betriebssystem	Debian 11+ / Ubuntu 22.04+
Node.js	20.x oder 22.x LTS
MariaDB	10.6+
Apache	2.4+ (mit mod_proxy, mod_proxy_http, mod_headers, mod_ssl)
Domain	Eine Subdomain, die auf deinen Server zeigt, etwa paste.example.com
SSL	Let's Encrypt, das übernimmt das Installationsskript

tipp

MSK Paste läuft in einem einzigen Node-Prozess auf Port 3012 und legt seine Daten in MariaDB ab. Kein Redis, keine weiteren Dienste.

---

Automatische Installation (empfohlen)

Im Repository liegt ein interaktives Skript install.sh, das alles erledigt: Node.js einrichten, Datenbank anlegen, .env erzeugen, Apache-vHost, SSL-Zertifikat und den systemd-Dienst.

# 1. Repository klonen
sudo git clone https://github.com/MSK-Scripts/msk-paste.git /opt/msk-paste
cd /opt/msk-paste

# 2. Installationsskript als root ausführen
sudo bash deployment/scripts/install.sh

Das Skript fragt dich nach:

• deiner Domain, etwa paste.example.com
• einem starken Datenbankpasswort
• einer E-Mail-Adresse für Let's Encrypt
• einem Geheimnis für den IP-Hash (wird automatisch mit openssl rand -hex 32 erzeugt)

Ist es durch, läuft der Dienst unter deiner Domain über HTTPS.

---

Installation von Hand

Wenn du lieber Schritt für Schritt vorgehst:

1. Node.js 22 installieren

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

2. MariaDB installieren

sudo apt install -y mariadb-server
sudo mysql_secure_installation

3. Datenbank und Nutzer anlegen

CREATE DATABASE msk_paste CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'msk_paste'@'localhost' IDENTIFIED BY 'change_me_strong_password';
GRANT ALL PRIVILEGES ON msk_paste.* TO 'msk_paste'@'localhost';
FLUSH PRIVILEGES;

4. Klonen und konfigurieren

sudo git clone https://github.com/MSK-Scripts/msk-paste.git /opt/msk-paste
cd /opt/msk-paste
sudo cp .env.example .env
sudo chmod 600 .env
sudo nano .env

Trage die Variablen ein, siehe Umgebungsvariablen weiter unten.

5. Abhängigkeiten installieren und bauen

sudo npm ci
sudo npm run migrate
sudo npm run build

6. systemd-Unit installieren

sudo cp msk-paste.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now msk-paste
sudo systemctl status msk-paste

7. Apache einrichten

sudo cp deployment/apache/msk-paste.conf /etc/apache2/sites-available/
# Datei an deine Domain anpassen
sudo nano /etc/apache2/sites-available/msk-paste.conf

sudo a2enmod proxy proxy_http headers ssl rewrite
sudo a2ensite msk-paste
sudo apache2ctl configtest
sudo systemctl reload apache2

8. SSL-Zertifikat ausstellen

sudo apt install -y certbot python3-certbot-apache
sudo certbot --apache -d paste.example.com

---

Umgebungsvariablen

# ─── Anwendung ───────────────────────────────────────────────────────
NODE_ENV=production
PORT=3012
NEXT_PUBLIC_BASE_URL=https://paste.example.com

# ─── Datenbank (MariaDB) ─────────────────────────────────────────────
DB_HOST=localhost
DB_PORT=3306
DB_USER=msk_paste
DB_PASSWORD=change_me_strong_password
DB_NAME=msk_paste

# ─── Sicherheit ──────────────────────────────────────────────────────
# Erzeugen mit:  openssl rand -hex 32
IP_HASH_SECRET=change_me_with_openssl_rand_hex_32

# ─── Grenzen ─────────────────────────────────────────────────────────
RATE_LIMIT_CREATE_PER_HOUR=10
MAX_PASTE_SIZE_BYTES=1048576           # 1 MB
PASTE_ID_LENGTH=8
PASTE_ID_MIN_CUSTOM=4
PASTE_ID_MAX_CUSTOM=32

warnung

Das IP_HASH_SECRET muss mindestens 32 Hex-Zeichen lang sein. Erzeuge es mit openssl rand -hex 32 und committe es niemals nach Git.

---

Geplante Aufgaben

Zwei Cronjobs halten deine Instanz in Schuss:

sudo crontab -e

# Tägliches Backup um 03:00 Uhr (14 Tage Aufbewahrung)
0 3 * * * /opt/msk-paste/deployment/scripts/backup.sh

# Abgelaufene Pastes um 03:30 Uhr aufräumen
30 3 * * * cd /opt/msk-paste && /usr/bin/npx tsx scripts/cleanup.ts

---

Aktualisieren

Im Repository liegt ein Skript update.sh für Updates von Hand:

sudo bash /opt/msk-paste/deployment/scripts/update.sh

Es holt den neuesten Commit, installiert die Abhängigkeiten, führt die Migrationen aus, baut neu und startet den Dienst neu.

Hast du den Deploy über GitHub Actions eingerichtet, passiert das bei jedem Push auf main automatisch.

---

Die Installation prüfen

# Status des Dienstes
sudo systemctl status msk-paste

# Logs live mitlesen
sudo journalctl -u msk-paste -f

# Antwortet er lokal?
curl -I http://localhost:3012

# Antwortet er öffentlich über HTTPS?
curl -I https://paste.example.com

Du solltest HTTP/2 200 sehen, lokal HTTP/1.1 200 OK.

---

Fehlersuche

Häufige Probleme wie 502 Bad Gateway, belegte Ports und die Ratenbegrenzung von Let's Encrypt stehen in der FAQ.