iac/iac-bookstack
3
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
2 commits 1 branch 0 tags 43 KiB
  • Shell 59.1%
  • Jinja 40.9%
Find a file
Exact
Kevin Heyer 90a8aaf613
All checks were successful
/ lint (push) Successful in 5m36s
Details
Add the agent pointer for Mistral Vibe 
.vibe/AGENTS.md points to AGENTS.md like .cursorrules, .clinerules and
.windsurfrules (same content), so Vibe reads the project instructions.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011yGoNphy8jxVZD7Jhd9a7T
2026-10-15 12:23:51 +02:00
.forgejo/workflows Add BookStack app 2026-10-15 11:48:05 +02:00
.vibe Add the agent pointer for Mistral Vibe 2026-10-15 12:23:51 +02:00
files Add BookStack app 2026-10-15 11:48:05 +02:00
handlers Add BookStack app 2026-10-15 11:48:05 +02:00
tasks Add BookStack app 2026-10-15 11:48:05 +02:00
templates Add BookStack app 2026-10-15 11:48:05 +02:00
tests Add BookStack app 2026-10-15 11:48:05 +02:00
.clinerules Add BookStack app 2026-10-15 11:48:05 +02:00
.cursorrules Add BookStack app 2026-10-15 11:48:05 +02:00
.windsurfrules Add BookStack app 2026-10-15 11:48:05 +02:00
AGENTS.md Add BookStack app 2026-10-15 11:48:05 +02:00
CHANGELOG.md Add BookStack app 2026-10-15 11:48:05 +02:00
CLAUDE.md Add BookStack app 2026-10-15 11:48:05 +02:00
GEMINI.md Add BookStack app 2026-10-15 11:48:05 +02:00
iac.json Add BookStack app 2026-10-15 11:48:05 +02:00
README.md Add BookStack app 2026-10-15 11:48:05 +02:00

README.md

iac-bookstack

BookStack als LXC oder VM auf Proxmox VE. Teil von iac.

BookStack ist eine Wiki- und Dokumentationsplattform (PHP/Laravel) mit MariaDB, ausgeliefert über nginx und php-fpm auf Port 80. Die Version kommt aus den GitHub-Releases des Projekts und wird per git (Release-Tag, offizieller Weg) installiert – das Projekt veröffentlicht keine Prüfsummen.

Installation (auf der Proxmox-Node)

bash -c "$(curl -fsSL https://iac.heyer.systems/bookstack/ct.sh)"   # LXC
bash -c "$(curl -fsSL https://iac.heyer.systems/bookstack/vm.sh)"   # VM

Ohne Dialog: IAC_NONINTERACTIVE=1 und var_*-Variablen – am einfachsten mit dem Generator auf https://iac.heyer.systems/apps/bookstack/.

Anmeldung

  • Adresse: http://<ip>/
  • Benutzer: admin@example.com
  • Passwort: grep bookstack_admin_password /etc/iac/settings.env (im Gast)

Das Passwort wird beim ersten Lauf gesetzt und danach nie wieder angefasst. Der mitgelieferte Standard-Admin (admin@admin.com) wird dabei umbenannt – ein Wechsel des Passworts ist danach in der Oberfläche möglich und bleibt erhalten.

Ports

Port Zweck Zugriff
80/tcp BookStack-Oberfläche (nginx) öffentlich

MariaDB lauscht nur auf localhost. Die Konfiguration liegt in /opt/bookstack/.env, die Daten in /opt/bookstack/storage und /opt/bookstack/public/uploads. Eigene Einstellungen gehören in die Admin-Oberfläche (Settings), nicht in die von iac verwalteten Dateien – update schreibt .env neu.

Reverse Proxy

Ohne weitere Einstellung baut BookStack seine Links aus der Adresse, unter der es aufgerufen wird (IP oder DNS-Name). Hinter einem Reverse Proxy mit HTTPS die öffentliche URL setzen – beim Anlegen mit var_bookstack_url=https://wiki.example.org oder später im Gast in /etc/iac/settings.env (bookstack_url=…), danach update.

Update (im Gast)

update

update wechselt auf den neuesten Release-Tag, installiert die Composer-Abhängigkeiten und führt die Datenbank-Migrationen aus. BookStack-Daten und Passwörter bleiben erhalten.

Mail

Es ist kein Mailserver eingerichtet; BookStack schreibt Mails ins Log (MAIL_DRIVER=log). Einladungen und „Passwort vergessen“ funktionieren deshalb nicht per Mail.

Selbsttest (im Gast)

bash /var/lib/iac/src/core/bin/iac-smoke