Un peu de montage requis. Pas tant que ça.

Votre propre app de collection. À vos conditions.

KolleK est une app de collection complète que vous pouvez exécuter sur l'infrastructure de votre choix. Commencez avec Docker Compose, gardez les rouages compréhensibles et conservez un chemin clair pour les mises à jour et les sauvegardes.

bash — kollek@server: ~/kollek

Étape 1 · Cloner

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

Cloning into 'kollek'... done.

Étape 2 · Configurer

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

Set APP_KEY, DB_PASSWORD in .env

Étape 3 · Définir la clé d'application

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

Application key set.

Étape 4 · Démarrer

$ docker compose up -d

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

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

Quatre commandes, d'un répertoire vide à une instance qui tourne. La dernière est “docker compose up”, pas un acte de foi.

Un court chemin de rien à en marche

Le chemin pris en charge, c'est Docker.

Démarrez l'app web, le worker de file, le planificateur, la base de données et le stockage avec une configuration documentée, au lieu d'assembler une stack à partir de messages de forum et d'optimisme.

1

Cloner le dépôt

git clone …/kollek

Récupérez le code source et la stack Compose fournie avec.

2

Configurez votre .env

cp .env.docker.example .env

Copiez le fichier d'exemple, puis définissez votre clé d'application et le mot de passe de la base.

3

Lancer Compose

docker compose up -d

Quatre conteneurs démarrent ensemble : app, queue, scheduler et MySQL.

4

Ça tourne

http://localhost:8000

Les migrations s'exécutent au démarrage. Ouvrez l'app dans votre navigateur.

Assez petit pour être compris

Cinq éléments. Voilà toute la distribution.

KolleK utilise un rôle web, un rôle file, un rôle planificateur, MySQL et un stockage durable. Chaque élément a un rôle, et chacun est décrit dans la documentation.

Stack Compose docker-compose.yml · 4 services

Application

Web app

Sert l'app via nginx et PHP-FPM, et exécute les migrations de base de données au démarrage.

Worker de file queue

Traite les tâches en arrière-plan sur les files high, default et low.

Planificateur scheduler

Exécute le planificateur artisan : tâches récurrentes de nettoyage et de maintenance.

lit & écrit

État & stockage

MySQL VOLUME DURABLE

Contient votre collection, vos objets, vos exemplaires et l'historique : la source de vérité.

db-data → /var/lib/mysql

Stockage durable VOLUME DURABLE

Photos, documents et fichiers générés téléversés. Disque local ou tout bucket compatible S3.

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

Mettez à jour sans retenir votre souffle

Vos volumes de données survivent au remplacement.

Les mises à jour préservent les volumes de données qui contiennent la base de données et les fichiers téléversés. Suivez le chemin de mise à jour documenté, exécutez les migrations et continuez.

Les conteneurs sont remplacés. Les volumes nommés restent en place, le remplacement touche donc le code, pas votre collection.
Exécution de mise à jour v3.2 → v3.3
1

Récupérer la nouvelle image

docker compose pull

Code
2

Sauvegarder d'abord

docker compose exec mysql mysqldump kollek > db.sql

Sécurité
3

Recréer les conteneurs

docker compose up -d

Volumes conservés
4

Migrations au démarrage

php artisan migrate --force

Automatique

Les sauvegardes font partie du contrat

Trois choses, sauvegardées ensemble.

Une sauvegarde fiable inclut la base de données, les fichiers téléversés et la clé d'application. Ce n'est pas glamour. Ça vaut vraiment le coup.

Liste de sauvegarde 3 sur 3 couverts
La base de données db-data

Chaque objet, collection, estimation et entrée d'historique. Un mysqldump ou un instantané de volume conviennent tous les deux.

ESSENTIEL
Fichiers téléversés storage-data

Photos, documents et pièces jointes. Restaurer une base de données sans eux laisse des références cassées.

ESSENTIEL
La clé d'application .env → APP_KEY

KolleK chiffre les données au repos ; sans cette clé, les valeurs chiffrées ne peuvent pas être relues. Facile à oublier, douloureux à perdre.

NE PAS OUBLIER

Aucune commande de sauvegarde automatisée n'est encore fournie. Faites un instantané des deux volumes nommés, gardez votre APP_KEY en lieu sûr, et les outils Docker standard s'occupent du reste.

Prêt à l'exécuter vous-même ?

Un seul chemin documenté couvre l'installation, la mise à jour et la sauvegarde. Commencez avec Docker Compose et gardez chaque rouage sous les yeux.

Lire le guide d'installation

KolleK n'est peut-être pas (encore) fait pour vous si…

Vous voulez un service hébergé sans maintenance et ne jamais voir Docker.

Vous avez besoin d'une plateforme de déploiement qui prenne chaque décision opérationnelle à votre place.

Choisissez KolleK quand…

Vous voulez un chemin documenté et pris en charge pour exécuter l'app complète sur l'infrastructure de votre choix.

Un petit serveur, Docker Compose et un modèle d'exploitation clair vous semblent une bonne nouvelle.

Nous mettrons cette page à jour quand le produit évoluera. La page d'état des fonctionnalités contient les détails ennuyeux mais importants.