deploykit_docs

docs Quickstart

Quickstart

Despliega tu primera aplicación en unos pocos pasos.

1. Crea tu cuenta de administrador

Cuando abras el panel por primera vez y todavía no exista ninguna cuenta, verás un formulario de registro. Introduce tu email y una contraseña (8+ caracteres) para crear la cuenta de administrador, que tiene control total sobre la plataforma. El registro se cierra tras el primer usuario: al resto los invita un administrador desde Users. Si pasaste --admin-email al instalador y funcionó, simplemente inicia sesión.

2. Sigue la checklist de bienvenida

El panel muestra una tarjeta Welcome to DeployKit hasta que despliegas tu primera aplicación o base de datos. Te guía a través de tres pasos:

  • Conecta un servidor — haz clic en “Use local server” para registrar la máquina en la que se ejecuta DeployKit (solo administradores), o añade un servidor remoto por SSH desde Servers
  • Crea un proyecto — los proyectos agrupan aplicaciones, bases de datos, stacks y servidores de juegos relacionados, y tienen sus propios roles de miembros
  • Despliega desde una plantilla — “Browse templates” abre el catálogo de un clic de bases de datos, aplicaciones autoalojadas y stacks completos

3. Añade una aplicación

Para desplegar tu propio código en lugar de una plantilla, abre el proyecto y haz clic en Add Application. Elige el origen (GitHub, GitLab, cualquier URL de Git o una imagen de Docker), la rama, el tipo de build (Nixpacks para autodetección, Dockerfile o Buildpacks), el servidor de destino y el puerto en el que escucha tu app. Si hay una GitHub App conectada, puedes elegir el repositorio de una lista — repositorios privados incluidos, sin necesidad de token de acceso. La misma página del proyecto también tiene Add Database, Add Stack y New game server.

Enlace de puerto: tu app debe escuchar en el puerto que configures y enlazarse a 0.0.0.0, no a localhost. Una app que solo escucha en localhost dentro de su contenedor es inalcanzable a través de Traefik — el motivo más común por el que un despliegue termina bien pero el sitio no carga.

4. Despliega

Haz clic en Deploy en la página de la aplicación. DeployKit clona el repositorio, construye una imagen de Docker, inicia el contenedor con labels de Traefik para el enrutado y ejecuta el health check. Sigue los logs del build en tiempo real desde la pestaña Deployments. Después añade un dominio a la aplicación y apunta su DNS al servidor — el certificado se emite automáticamente.

Consejo: para repositorios de github.com, registra una GitHub App en Settings para que cada push se despliegue automáticamente, los despliegues informen de un estado de commit y los pull requests obtengan entornos de preview. Para GitLab o cualquier otro CI, usa webhooks.