gotosocial-vps/README.md

GoToSocial VPS – Instalační příručka

Tento repozitář obsahuje konfigurační soubory a skripty pro nasazení instance GoToSocial na VPS pomocí Dockeru a reverzního proxy Nginx.

Obsah

• Požadavky
• Struktura repozitáře
• Instalace
• Konfigurace
• Nginx
• Správa instance
• Zálohy

---

Požadavky

• VPS s Ubuntu 22.04 / Debian 12
• Docker a Docker Compose
• Doménové jméno s nastaveným DNS A záznamem na IP VPS
• Nginx
• Certbot (Let's Encrypt)

Struktura repozitáře

gotosocial-vps/
├── docker-compose.yml       # Docker Compose konfigurace
├── .env.example             # Vzor proměnných prostředí
├── config/
│   └── config.yaml          # Konfigurační soubor GoToSocial
├── nginx/
│   └── gotosocial.conf      # Nginx konfigurace (reverzní proxy)
└── scripts/
    ├── install.sh           # Skript pro první instalaci
    ├── update.sh            # Aktualizace GoToSocial
    └── backup.sh            # Záloha dat

Instalace

1. Příprava serveru

sudo apt update && sudo apt upgrade -y
sudo apt install -y docker.io docker-compose nginx certbot python3-certbot-nginx
sudo systemctl enable --now docker

2. Klonování repozitáře

git clone ssh://git@git.arch-linux.cz:29418/Archos/gotosocial-vps.git
cd gotosocial-vps

3. Nastavení proměnných prostředí

cp .env.example .env
nano .env

Vyplňte hodnoty – zejména GTS_HOST (vaše doména) a GTS_DB_PASSWORD.

4. Spuštění

chmod +x scripts/install.sh
./scripts/install.sh

Nebo ručně:

mkdir -p data
docker-compose up -d

5. SSL certifikát

sudo certbot --nginx -d vase-domena.cz

6. Nginx konfigurace

sudo cp nginx/gotosocial.conf /etc/nginx/sites-available/gotosocial
sudo ln -s /etc/nginx/sites-available/gotosocial /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

Konfigurace

Hlavní konfigurace se nachází v config/config.yaml. Nejdůležitější položky:

Položka	Popis
host	Vaše doména (např. social.example.cz)
protocol	https pro produkci
db-address	Cesta k SQLite nebo adresa Postgres
storage-local-base-path	Adresář pro ukládání médií
smtp-*	Nastavení e-mailu pro notifikace

Nginx

Soubor nginx/gotosocial.conf je šablona pro reverzní proxy. Před použitím upravte:

• server_name – nahraďte vase-domena.cz vaší doménou
• Cesty k SSL certifikátům (vyplní Certbot automaticky)

Správa instance

# Vytvoření admin účtu
docker-compose exec gotosocial /gotosocial/gotosocial admin account create \
  --username admin \
  --email admin@vase-domena.cz \
  --password "silne_heslo"

# Přiřazení admin role
docker-compose exec gotosocial /gotosocial/gotosocial admin account promote \
  --username admin

# Zobrazení logů
docker-compose logs -f gotosocial

# Restart
docker-compose restart gotosocial

Zálohy

Zálohovací skript uloží data a konfiguraci do archivu:

chmod +x scripts/backup.sh
./scripts/backup.sh

Zálohy jsou ukládány do adresáře backups/ ve formátu gotosocial-backup-YYYY-MM-DD.tar.gz.

Aktualizace

chmod +x scripts/update.sh
./scripts/update.sh

Skript stáhne nejnovější obraz GoToSocial a restartuje kontejner.