Requiere algo de montaje. Aunque no mucho.

Tu propia app de colección. En tus términos.

KolleK es una app de colección completa que puedes ejecutar en la infraestructura que elijas. Empieza con Docker Compose, mantén las piezas comprensibles y conserva una ruta clara para actualizaciones y copias de seguridad.

bash — kollek@server: ~/kollek

Paso 1 · Clonar

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

Cloning into 'kollek'... done.

Paso 2 · Configurar

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

Set APP_KEY, DB_PASSWORD in .env

Paso 3 · Definir la clave de la app

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

Application key set.

Paso 4 · Levantarlo

$ docker compose up -d

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

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

Cuatro comandos, de un directorio vacío a una instancia en marcha. El último es “docker compose up”, no un acto de fe.

Una ruta corta de la nada a en marcha

La ruta con soporte es Docker.

Levanta la app web, el worker de cola, el programador, la base de datos y el almacenamiento con una configuración documentada, en lugar de armar una stack a partir de foros y optimismo.

1

Clonar el repo

git clone …/kollek

Descarga el código fuente y la stack de Compose que lo acompaña.

2

Configura tu .env

cp .env.docker.example .env

Copia el env de ejemplo y luego define tu clave de app y la contraseña de la base de datos.

3

Levantar Compose

docker compose up -d

Cuatro contenedores arrancan juntos: app, queue, scheduler y MySQL.

4

Funciona

http://localhost:8000

Las migraciones se ejecutan al arrancar. Abre la app en tu navegador.

Lo bastante pequeño para entenderlo

Cinco partes. Ese es todo el reparto.

KolleK usa un rol web, un rol de cola, un rol de programador, MySQL y almacenamiento duradero. Cada parte tiene una función y cada una está descrita en la documentación.

Stack de Compose docker-compose.yml · 4 servicios

Aplicación

Web app

Sirve la app con nginx y PHP-FPM, y ejecuta las migraciones de la base de datos al arrancar.

Worker de cola queue

Procesa trabajos en segundo plano en las colas high, default y low.

Programador scheduler

Ejecuta el programador de artisan: tareas recurrentes de limpieza y mantenimiento.

lee y escribe

Estado y almacenamiento

MySQL VOLUMEN DURADERO

Guarda tu colección, artículos, copias e historial: la fuente de la verdad.

db-data → /var/lib/mysql

Almacenamiento duradero VOLUMEN DURADERO

Fotos, documentos y archivos generados subidos. Disco local o cualquier bucket compatible con S3.

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

Actualiza sin contener la respiración

Tus volúmenes de datos sobreviven al cambio.

Las actualizaciones conservan los volúmenes de datos que contienen la base de datos y los archivos subidos. Sigue la ruta de actualización documentada, ejecuta las migraciones y sigue adelante.

Los contenedores se reemplazan. Los volúmenes con nombre se quedan, así que el cambio afecta al código, no a tu colección.
Ejecución de actualización v3.2 → v3.3
1

Descargar la nueva imagen

docker compose pull

Código
2

Primero, respaldar

docker compose exec mysql mysqldump kollek > db.sql

Seguridad
3

Recrear los contenedores

docker compose up -d

Volúmenes conservados
4

Migraciones al arrancar

php artisan migrate --force

Automático

Las copias de seguridad son parte del trato

Tres cosas, respaldadas juntas.

Una copia fiable incluye la base de datos, los archivos subidos y la clave de la aplicación. No es glamuroso. Vale muchísimo la pena.

Lista de copia de seguridad 3 de 3 cubiertos
La base de datos db-data

Cada artículo, colección, valoración y entrada de historial. Un mysqldump o una instantánea de volumen sirven igual.

ESENCIAL
Archivos subidos storage-data

Fotos, documentos y adjuntos. Restaurar una base de datos sin ellos deja referencias rotas.

ESENCIAL
La clave de la aplicación .env → APP_KEY

KolleK cifra los datos en reposo, así que sin esta clave los valores cifrados no se pueden volver a leer. Fácil de olvidar, doloroso de perder.

NO OMITIR

Todavía no se incluye un comando de copia de seguridad automatizado. Haz una instantánea de los dos volúmenes con nombre, guarda tu APP_KEY en un lugar seguro y las herramientas estándar de Docker se encargan del resto.

¿Listo para ejecutarlo tú mismo?

Una sola ruta documentada cubre instalación, actualización y copia de seguridad. Empieza con Docker Compose y mantén cada pieza a la vista.

Leer la guía de instalación

KolleK puede que (todavía) no sea para ti si…

Quieres un servicio alojado sin mantenimiento y no ver nunca Docker.

Necesitas una plataforma de despliegue que tome cada decisión operativa por ti.

Elige KolleK cuando…

Quieres una ruta documentada y con soporte para ejecutar la app completa en la infraestructura que elijas.

Un servidor pequeño, Docker Compose y un modelo operativo claro te suenan a buena noticia.

Actualizaremos esta página cuando el producto cambie. La página de estado de las funciones tiene los detalles aburridos pero importantes.