Etwas Zusammenbau nötig. Aber nicht viel.

Ihre eigene Sammlungs-App. Zu Ihren Bedingungen.

KolleK ist eine vollständige Sammlungs-App, die Sie auf einer Infrastruktur Ihrer Wahl betreiben können. Starten Sie mit Docker Compose, halten Sie die beweglichen Teile verständlich und behalten Sie einen klaren Weg für Upgrades und Backups.

bash — kollek@server: ~/kollek

Schritt 1 · Klonen

$ git clone https://github.com/djaiss/kollek.git kollek

Cloning into 'kollek'... done.

Schritt 2 · Konfigurieren

$ cd kollek && cp .env.docker.example .env

Set APP_KEY, DB_PASSWORD in .env

Schritt 3 · App-Schlüssel setzen

$ docker compose run --rm app php artisan key:generate

Application key set.

Schritt 4 · Hochfahren

$ docker compose up -d

Started app, queue, scheduler, mysql · migrations ran on boot

4 containers healthy · app on http://localhost:8000

Vier Befehle, von einem leeren Verzeichnis zu einer laufenden Instanz. Der letzte ist “docker compose up”, kein Vertrauenssprung.

Ein kurzer Weg von nichts zu läuft

Der unterstützte Weg ist Docker.

Fahren Sie Web-App, Queue-Worker, Scheduler, Datenbank und Speicher mit einer dokumentierten Einrichtung hoch, statt einen Stack aus Forenbeiträgen und Optimismus zusammenzubauen.

1

Repository klonen

git clone …/kollek

Holen Sie den Quellcode und den mitgelieferten Compose-Stack.

2

Ihre .env einrichten

cp .env.docker.example .env

Kopieren Sie die Beispiel-Env und setzen Sie dann App-Schlüssel und Datenbankpasswort.

3

Compose starten

docker compose up -d

Vier Container starten zusammen: app, queue, scheduler und MySQL.

4

Es läuft

http://localhost:8000

Migrationen laufen beim Start. Öffnen Sie die App im Browser.

Klein genug, um es zu verstehen

Fünf Teile. Das ist die ganze Besetzung.

KolleK nutzt eine Web-Rolle, eine Queue-Rolle, eine Scheduler-Rolle, MySQL und dauerhaften Speicher. Jeder Teil hat eine Aufgabe, und jeder ist in der Dokumentation beschrieben.

Compose-Stack docker-compose.yml · 4 Services

Anwendung

Web app

Stellt die App über nginx und PHP-FPM bereit und führt Datenbankmigrationen beim Start aus.

Queue-Worker queue

Verarbeitet Hintergrundjobs auf den Queues high, default und low.

Scheduler scheduler

Führt den artisan-Scheduler aus: wiederkehrende Aufräum- und Wartungsaufgaben.

liest & schreibt

Zustand & Speicher

MySQL DAUERHAFTES VOLUME

Enthält Ihre Sammlung, Objekte, Exemplare und den Verlauf: die Quelle der Wahrheit.

db-data → /var/lib/mysql

Dauerhafter Speicher DAUERHAFTES VOLUME

Hochgeladene Fotos, Dokumente und generierte Dateien. Lokale Festplatte oder ein beliebiger S3-kompatibler Bucket.

storage-data → /var/www/html/storage

Aktualisieren ohne den Atem anzuhalten

Ihre Datenvolumes überstehen den Wechsel.

Updates bewahren die Datenvolumes, die Datenbank und hochgeladene Dateien enthalten. Folgen Sie dem dokumentierten Upgrade-Weg, führen Sie die Migrationen aus und machen Sie weiter.

Container werden ersetzt. Die benannten Volumes bleiben, sodass der Wechsel den Code betrifft, nicht Ihre Sammlung.
Upgrade-Lauf v3.2 → v3.3
1

Neues Image ziehen

docker compose pull

Code
2

Zuerst sichern

docker compose exec mysql mysqldump kollek > db.sql

Sicherheit
3

Container neu erstellen

docker compose up -d

Volumes bleiben
4

Migrationen beim Start

php artisan migrate --force

Automatisch

Backups gehören dazu

Drei Dinge, zusammen gesichert.

Ein zuverlässiges Backup umfasst die Datenbank, die hochgeladenen Dateien und den Anwendungsschlüssel. Nicht glamourös. Aber extrem lohnenswert.

Backup-Checkliste 3 von 3 abgedeckt
Die Datenbank db-data

Jedes Objekt, jede Sammlung, jede Bewertung und jeder Verlaufseintrag. Ein mysqldump oder ein Volume-Snapshot funktionieren beide.

UNVERZICHTBAR
Hochgeladene Dateien storage-data

Fotos, Dokumente und Anhänge. Eine Datenbank ohne sie wiederherzustellen hinterlässt kaputte Verweise.

UNVERZICHTBAR
Der Anwendungsschlüssel .env → APP_KEY

KolleK verschlüsselt Daten im Ruhezustand, daher können ohne diesen Schlüssel die verschlüsselten Werte nicht mehr gelesen werden. Leicht zu vergessen, schmerzhaft zu verlieren.

NICHT AUSLASSEN

Ein automatisierter Backup-Befehl wird noch nicht mitgeliefert. Erstellen Sie einen Snapshot der beiden benannten Volumes, bewahren Sie Ihren APP_KEY sicher auf, und die üblichen Docker-Werkzeuge erledigen den Rest.

Bereit, es selbst zu betreiben?

Ein dokumentierter Weg deckt Installation, Upgrade und Backup ab. Starten Sie mit Docker Compose und behalten Sie jedes bewegliche Teil im Blick.

Installationsanleitung lesen

KolleK ist vielleicht (noch) nichts für Sie, wenn…

Sie wollen einen wartungsfreien gehosteten Dienst und Docker nie sehen.

Sie brauchen eine Deployment-Plattform, die jede betriebliche Entscheidung für Sie trifft.

Wählen Sie KolleK, wenn…

Sie möchten einen dokumentierten, unterstützten Weg, die vollständige App auf einer Infrastruktur Ihrer Wahl zu betreiben.

Ein kleiner Server, Docker Compose und ein klares Betriebsmodell klingen für Sie nach guten Nachrichten.

Wir aktualisieren diese Seite, wenn sich das Produkt ändert. Die Statusseite der Funktionen enthält die langweiligen, aber wichtigen Details.