Capitulo 4: Panel de Control

< Volver al Indice del Tutorial

Navegacion por el Panel

El panel de Dokploy se organiza con una barra lateral (sidebar) a la izquierda y el contenido principal a la derecha. Las secciones principales son:

Sidebar

• Projects: Lista y gestion de todos los proyectos. Es la seccion donde pasaras la mayor parte del tiempo.
• Monitoring: Graficas en tiempo real de CPU, memoria, disco y red del servidor.
• Traefik: Configuracion del reverse proxy, certificados SSL y rutas.
• Docker: Vista directa de contenedores, imagenes, volumenes y redes del servidor.
• Settings: Configuracion general del servidor, usuarios, notificaciones y actualizaciones.

Barra superior

En la parte superior del panel encontraras:

• Nombre del servidor: Identificador de la instancia de Dokploy.
• Notificaciones: Alertas de builds, deploys y errores.
• Perfil: Acceso a configuracion de cuenta, 2FA y logout.

Crear un Proyecto

En Dokploy, un proyecto es un contenedor logico que agrupa aplicaciones y bases de datos relacionadas. Por ejemplo, un proyecto “Mi SaaS” puede contener una app frontend, un backend API y una base de datos PostgreSQL.

Pasos para crear un proyecto

1. Haz clic en Projects en el sidebar.
2. Haz clic en el boton Create Project.
3. Asigna un nombre descriptivo (ej: “blog-personal”, “api-produccion”).
4. Opcionalmente agrega una descripcion.
5. Haz clic en Create.

El proyecto aparece en la lista y al hacer clic en el puedes agregar servicios.

Estructura de un proyecto

Dentro de un proyecto puedes crear:

• Applications: Servicios web desplegados desde un repositorio Git o imagen Docker.
• Databases: Instancias de PostgreSQL, MySQL, MongoDB, Redis o MariaDB gestionadas por Dokploy.
• Compose: Stacks de Docker Compose completos.

Seccion: Applications

Las aplicaciones son el nucleo de Dokploy. Al crear una aplicacion dentro de un proyecto, configuras:

Origen del codigo

• GitHub: Conecta tu cuenta de GitHub y selecciona repositorio y rama.
• GitLab: Integracion con repositorios GitLab.
• Bitbucket: Soporte para repositorios Bitbucket.
• Git URL: Cualquier repositorio Git accesible por URL.
• Docker Image: Despliega directamente una imagen de Docker Hub o registry privado.

Metodo de build

• Nixpacks: Deteccion automatica del lenguaje y dependencias. Funciona sin configuracion para la mayoria de frameworks.
• Dockerfile: Usa un Dockerfile del repositorio para builds personalizados.
• Buildpacks: Similar a Nixpacks pero usando Cloud Native Buildpacks.
• Docker Image: Sin build, despliega la imagen directamente.

Configuracion de la aplicacion

Cada aplicacion tiene pestanas de configuracion:

• General: Nombre, rama, metodo de build, comando de inicio.
• Environment: Variables de entorno.
• Domains: Dominios y SSL asociados.
• Deployments: Historial de deploys con logs.
• Monitoring: Metricas especificas de la aplicacion.
• Logs: Logs en tiempo real del contenedor.
• Terminal: Acceso shell al contenedor (para debug).
• Advanced: Puertos, volumenes, recursos, health checks.

Seccion: Databases

Dokploy gestiona bases de datos como servicios de primera clase. Al crear una base de datos:

1. Seleccionas el motor: PostgreSQL, MySQL, MongoDB, Redis o MariaDB.
2. Defines nombre y credenciales (o Dokploy las genera automaticamente).
3. Opcionalmente configuras version, recursos y backups.

Cada base de datos incluye:

• Connection string generado automaticamente.
• Panel de administracion para ver metricas.
• Backups programables con destino local o S3.
• Logs del motor de base de datos.

Las bases de datos son accesibles desde cualquier aplicacion dentro de la red interna de Dokploy usando el nombre del servicio como hostname.

Seccion: Compose

Para stacks mas complejos, Dokploy permite desplegar archivos docker-compose.yml completos. Esto es util cuando:

• Tienes un docker-compose.yml existente que funciona localmente.
• Necesitas multiples servicios interconectados con configuracion especifica.
• Quieres gestionar la infraestructura como codigo.

Al crear un servicio Compose:

1. Pegas o subes tu docker-compose.yml.
2. Opcionalmente defines variables de entorno.
3. Dokploy despliega todos los servicios definidos en el archivo.

Seccion: Settings

La configuracion general se divide en varias subsecciones:

Server

• Server Domain: El dominio principal del panel (ej: panel.tudominio.com).
• Server IP: IP publica del servidor.
• Update: Boton para actualizar Dokploy a la ultima version.
• Cleanup: Limpieza de imagenes Docker no utilizadas para liberar disco.

Profile

• Email: Email de la cuenta de administrador.
• Password: Cambio de contrasena.
• 2FA: Activar autenticacion de dos factores con TOTP.

Users

• Crear y gestionar usuarios adicionales.
• Asignar roles y permisos por proyecto.

SSH Keys

• Gestionar claves SSH para acceso a repositorios privados.
• Necesarias si usas Git URL con autenticacion SSH.

Notifications

Configurar notificaciones para eventos (deploy exitoso, error, etc.):

• Slack: Webhook a un canal.
• Discord: Webhook a un canal.
• Telegram: Bot y chat ID.
• Email: Notificaciones por correo (requiere SMTP).

Certificates

• Gestion de certificados SSL.
• Configuracion de Let’s Encrypt.
• Soporte para certificados personalizados.

Configuracion Inicial del Panel

Despues de la instalacion, hay configuraciones recomendadas para dejar el panel listo para produccion.

Configurar el hostname

Ve a Settings > Server y establece el dominio principal. Esto permite que Traefik genere un certificado SSL para el panel:

1. Apunta un registro DNS tipo A desde tu dominio al IP del servidor.
2. En Settings > Server, ingresa el dominio (ej: panel.tudominio.com).
3. Dokploy configura Traefik automaticamente con SSL.

Configurar timezone

En Settings > Server, selecciona la zona horaria correcta. Esto afecta los logs y las programaciones de backups.

Activar 2FA

En Settings > Profile > 2FA:

1. Haz clic en “Enable 2FA”.
2. Escanea el codigo QR con tu app de autenticacion (Google Authenticator, Authy, 1Password).
3. Ingresa el codigo de verificacion.
4. Guarda los codigos de respaldo en un lugar seguro.

Agregar clave SSH para GitHub

Si vas a desplegar desde repositorios privados:

1. Ve a Settings > SSH Keys.
2. Genera un nuevo par de claves o sube una existente.
3. Copia la clave publica y agregala como Deploy Key en tu repositorio de GitHub.

Limpiar imagenes Docker

Con el tiempo, las imagenes de builds anteriores acumulan espacio. En Settings > Server > Cleanup puedes:

• Ejecutar limpieza manual.
• Programar limpieza automatica periodica.

Atajos y Tips de Navegacion

• Usa la barra de busqueda (parte superior) para encontrar proyectos y aplicaciones rapidamente.
• Los logs se actualizan en tiempo real; no necesitas recargar la pagina.
• El monitoring del sidebar muestra metricas del servidor completo, mientras que el monitoring dentro de una aplicacion muestra solo esa aplicacion.
• Puedes reordenar proyectos en la lista arrastrando.

---

Siguiente: Capitulo 5: Primer Deploy —>