mkanban_

Documentación

Guía de instalación y operación · modalidad on-premises

Requisitos

Dominios de egress

Para entornos con firewall de salida, esta es la lista completa a autorizar:

DestinoUso
api.anthropic.comLlamadas de los agentes al modelo (con tu API key)
github.com · api.github.comClones, pull requests, issues, milestones
registry.npmjs.orgRuntime de los agentes de código
ghcr.io · pkg-containers.githubusercontent.comDescarga de imágenes y actualizaciones

Instalación

El bundle de instalación (entregado por mdevel) contiene tres archivos: docker-compose.yml, .env.example y update.sh.

sudo mkdir -p /opt/mkanban && cd /opt/mkanban
# copiar los tres archivos del bundle a este directorio
cp .env.example .env && chmod 600 .env
vi .env               # completar credenciales del registro
chmod +x update.sh
./update.sh           # primer arranque: descarga la imagen y levanta el servicio

La interfaz queda disponible en http://<servidor>:3000. El login de GitHub se hace desde la propia interfaz (device flow); la API key del modelo se configura en Ajustes.

Persistencia: los datos viven en los volúmenes Docker mk-repos (repositorios de trabajo) y mk-home (base de datos, configuración y credenciales). Sobreviven a cualquier actualización o recreación del contenedor.

Actualizaciones

update.sh es idempotente: si no hay versión nueva, no hace nada. Programado por cron, mantiene la instancia al día sin intervención:

echo '17 4 * * * root /opt/mkanban/update.sh >> /var/log/mkanban-update.log 2>&1' \
  | sudo tee /etc/cron.d/mkanban-update

Ante una versión nueva, el updater: hace backup de los datos → levanta la versión nueva → espera el healthcheck → si no supera la verificación, revierte automáticamente a la versión anterior y restaura el backup. Los últimos 10 backups quedan en /opt/mkanban/backups/.

Soporte

Canal de soporte según el plan contratado. Contacto general: sales@mdevel.dev.