Arcane Docker Compose es la solución moderna de gestión de contenedores que está revolucionando la forma en que los desarrolladores y administradores de sistemas manejan sus entornos Docker. Si buscas una alternativa más elegante y funcional a Portainer, has llegado al lugar indicado.
Qué es Arcane Docker Compose y Por Qué Deberías Usarlo
Arcane es una plataforma de gestión Docker de código abierto diseñada para ofrecer una experiencia de usuario superior. A diferencia de otras soluciones tradicionales, esta herramienta combina una interfaz limpia y moderna con funcionalidades avanzadas totalmente gratuitas.
La aplicación te permite administrar contenedores, imágenes, volúmenes y redes desde un único dashboard intuitivo. Lo mejor de todo es que no tiene restricciones empresariales como otras plataformas, brindándote acceso completo a todas sus características sin costos adicionales.
El proyecto está construido con tecnologías modernas como SvelteKit y Go, lo que garantiza un rendimiento excepcional y una experiencia fluida tanto en escritorio como en dispositivos móviles.
Características Principales de Arcane Docker Compose
Esta solución destaca por ofrecer un conjunto completo de funcionalidades que facilitan la gestión de entornos containerizados:
- Interfaz responsive y moderna: Diseñada para funcionar perfectamente en cualquier dispositivo, incluidos smartphones
- Monitorización en tiempo real: Visualiza el uso de CPU, memoria y red de forma clara y comprensible
- Gestión completa de contenedores: Inicia, detén, reinicia e inspecciona tus contenedores con un solo clic
- Administración de imágenes: Descarga, elimina y gestiona imágenes Docker fácilmente
- Control de redes y volúmenes: Crea y configura redes Docker y almacenamiento persistente
- Actualizaciones automáticas: Mantén tus contenedores actualizados cuando hay nuevas versiones disponibles
- Limpieza con un clic: Elimina imágenes, volúmenes y redes no utilizados para liberar espacio
- Soporte Docker Compose: Gestiona aplicaciones multi-contenedor con archivos compose
Instalación de Arcane Docker Compose: Paso a Paso
Desplegar Arcane Docker Compose en tu servidor es un proceso sencillo que solo requiere unos minutos. A continuación te muestro cómo hacerlo correctamente.
Requisitos Previos
Antes de comenzar, asegúrate de tener instalado:
- Docker Engine 20.10 o superior
- Docker Compose v2.0 o superior
- Un servidor Linux (Ubuntu, Debian, CentOS, etc.)
- Acceso SSH a tu servidor
Archivo Docker Compose para Arcane
Crea un directorio para el proyecto y dentro de él, crea un archivo docker-compose.yml con la siguiente configuración:
version: '3.8'
services:
arcane:
image: ghcr.io/getarcaneapp/arcane:latest
container_name: arcane
restart: unless-stopped
ports:
- "3552:3000"
volumes:
- /var/run/docker.sock:/var/run/docker.sock:ro
- arcane-data:/app/data
environment:
- APP_URL=http://tu-servidor:3552
- PUID=1000
- PGID=1000
- ENCRYPTION_KEY=tu-clave-secreta-aqui-32-caracteres
- JWT_SECRET=tu-jwt-secret-aqui-64-caracteres
- APP_ENV=production
- PUBLIC_SESSION_SECRET=tu-session-secret-aqui-32-chars
volumes:
arcane-data:
driver: local
Configuración de Variables de Entorno
Es importante personalizar las variables de entorno para asegurar tu instalación:
- APP_URL: Cambia esto por la URL donde accederás al servicio
- ENCRYPTION_KEY: Genera una clave de 32 caracteres para cifrado
- JWT_SECRET: Crea un secret de 64 caracteres para tokens JWT
- PUBLIC_SESSION_SECRET: Genera una clave de sesión de 32 caracteres
Para generar claves seguras, puedes usar este comando:
openssl rand -base64 32
Iniciar Arcane
Una vez configurado el archivo, ejecuta el siguiente comando en el directorio donde guardaste el docker-compose.yml:
docker compose up -d
El sistema descargará la imagen y iniciará el contenedor en segundo plano. Luego, accede a la interfaz web desde tu navegador en http://tu-servidor:3552.
Primeros Pasos con Arcane Docker Compose
Al acceder por primera vez a la plataforma, deberás crear una cuenta de administrador. El proceso es simple e intuitivo:
- Abre tu navegador y accede a la URL configurada
- Completa el formulario de registro inicial
- Configura tu nombre de usuario y contraseña
- Accede al dashboard principal
Una vez dentro, verás un dashboard limpio y organizado que muestra todos tus contenedores activos, recursos del sistema y opciones de gestión.
Gestión de Contenedores con Arcane Docker Compose
El panel de control te permite realizar todas las operaciones comunes de Docker desde una interfaz gráfica intuitiva.
Visualizar y Controlar Contenedores
Desde la sección de contenedores puedes:
- Ver el estado en tiempo real de cada contenedor
- Iniciar, detener o reiniciar servicios con un clic
- Acceder a los logs para debugging
- Inspeccionar la configuración y variables de entorno
- Abrir una terminal interactiva dentro del contenedor
Gestión de Imágenes
El gestor te facilita la administración de imágenes Docker:
- Descarga nuevas imágenes desde Docker Hub o registros privados
- Visualiza el tamaño y tags de cada imagen
- Elimina imágenes no utilizadas para recuperar espacio
- Actualiza imágenes con un solo clic
Administración de Volúmenes y Redes
La herramienta incluye gestión completa de recursos Docker:
- Crea y elimina volúmenes para datos persistentes
- Configura redes personalizadas para aislar servicios
- Visualiza qué contenedores usan cada recurso
- Limpia recursos huérfanos automáticamente
Arcane vs Portainer: Comparación Detallada
Muchos usuarios se preguntan cuál es mejor entre Arcane y Portainer. Aquí te presento una comparación objetiva:
Interfaz de Usuario
Arcane ofrece un diseño moderno, limpio y responsive que funciona perfectamente en móviles. La navegación es intuitiva y los elementos visuales están bien organizados.
Portainer tiene una interfaz más tradicional y menos optimizada para dispositivos móviles. Aunque funcional, puede sentirse menos moderna comparada con las alternativas actuales.
Características y Funcionalidades
Arcane ofrece todas sus funcionalidades de forma gratuita, sin restricciones empresariales. Incluye actualizaciones automáticas de contenedores y limpieza de recursos con un clic.
Portainer divide sus funcionalidades entre versiones Community y Business. Algunas características avanzadas requieren suscripción de pago.
Rendimiento y Recursos
Ambas soluciones son ligeras, pero el stack tecnológico moderno de este gestor (SvelteKit + Go) ofrece tiempos de carga más rápidos y menor consumo de recursos.
Casos de Uso y Aplicaciones Prácticas
La plataforma es ideal para diversos escenarios de uso:
Homelabs y Servidores Domésticos
Gestiona tu homelab con facilidad, controlando servicios como Nextcloud, Jellyfin, Home Assistant y más desde una única interfaz accesible desde tu móvil.
Entornos de Desarrollo
Los desarrolladores pueden gestionar múltiples entornos de desarrollo, crear y eliminar contenedores de prueba, y monitorizar el consumo de recursos de sus aplicaciones.
Servidores de Producción
Aunque está diseñado pensando en la simplicidad, el sistema es lo suficientemente robusto para gestionar entornos de producción pequeños y medianos con monitorización en tiempo real.
Configuración Avanzada de Arcane Docker Compose
Para usuarios avanzados, hay varias opciones de configuración que mejoran la experiencia.
Proxy Inverso con SSL
Es recomendable colocar el servicio detrás de un proxy inverso como Nginx Proxy Manager o Caddy para añadir SSL y mejorar la seguridad:
version: '3.8'
services:
arcane:
image: ghcr.io/getarcaneapp/arcane:latest
container_name: arcane
restart: unless-stopped
expose:
- "3000"
volumes:
- /var/run/docker.sock:/var/run/docker.sock:ro
- arcane-data:/app/data
environment:
- APP_URL=https://arcane.tudominio.com
- PUID=1000
- PGID=1000
- ENCRYPTION_KEY=${ENCRYPTION_KEY}
- JWT_SECRET=${JWT_SECRET}
- APP_ENV=production
- PUBLIC_SESSION_SECRET=${PUBLIC_SESSION_SECRET}
networks:
- proxy
networks:
proxy:
external: true
volumes:
arcane-data:
driver: local
Socket Proxy para Mayor Seguridad
Montar directamente el socket de Docker puede ser un riesgo de seguridad. Para entornos sensibles, considera usar un socket proxy que limite los permisos:
version: '3.8'
services:
socket-proxy:
image: tecnativa/docker-socket-proxy
container_name: socket-proxy
restart: unless-stopped
volumes:
- /var/run/docker.sock:/var/run/docker.sock:ro
environment:
- CONTAINERS=1
- IMAGES=1
- NETWORKS=1
- VOLUMES=1
- INFO=1
networks:
- socket-proxy
arcane:
image: ghcr.io/getarcaneapp/arcane:latest
container_name: arcane
restart: unless-stopped
ports:
- "3552:3000"
volumes:
- arcane-data:/app/data
environment:
- DOCKER_HOST=tcp://socket-proxy:2375
- APP_URL=http://tu-servidor:3552
- PUID=1000
- PGID=1000
- ENCRYPTION_KEY=${ENCRYPTION_KEY}
- JWT_SECRET=${JWT_SECRET}
- APP_ENV=production
- PUBLIC_SESSION_SECRET=${PUBLIC_SESSION_SECRET}
networks:
- socket-proxy
depends_on:
- socket-proxy
networks:
socket-proxy:
driver: bridge
volumes:
arcane-data:
driver: local
Autenticación con OIDC
Para entornos corporativos, la aplicación soporta autenticación mediante OIDC (OpenID Connect), permitiendo integración con proveedores como Authelia, Authentik o Keycloak.
Solución de Problemas Comunes
Si encuentras problemas durante la instalación o uso, aquí tienes las soluciones más comunes:
No Puedo Acceder a la Interfaz Web
Verifica que el contenedor esté ejecutándose:
docker ps | grep arcane
Comprueba los logs para ver posibles errores:
docker logs arcane
Error de Permisos con el Socket de Docker
Si ves errores de permisos, asegúrate de que el usuario tenga acceso al socket:
sudo usermod -aG docker $USER
sudo chmod 666 /var/run/docker.sock
El Contenedor se Reinicia Constantemente
Esto suele indicar un problema con las variables de entorno. Verifica que todas las claves secretas estén configuradas correctamente y tengan la longitud adecuada.
Actualizaciones y Mantenimiento
Mantener tu instalación actualizada es sencillo gracias a Docker Compose:
docker compose pull
docker compose up -d
Estos comandos descargarán la última versión de la imagen y recrearán el contenedor sin perder tus datos, ya que están almacenados en un volumen persistente.
Para automatizar las actualizaciones, puedes usar Watchtower, una herramienta que actualiza automáticamente tus contenedores cuando hay nuevas versiones disponibles.
Preguntas Frecuentes sobre Arcane Docker Compose
¿Es seguro montar el socket de Docker?
Montar el socket de Docker da acceso completo al daemon, lo que puede ser un riesgo de seguridad. Para entornos de producción sensibles, se recomienda usar un socket proxy que limite los permisos. Para homelabs y entornos de desarrollo, el riesgo es generalmente aceptable.
¿Puedo gestionar múltiples servidores Docker?
Sí, el sistema soporta la gestión de entornos remotos. Puedes configurar múltiples endpoints Docker y cambiar entre ellos desde la interfaz web.
¿Funciona con Podman en lugar de Docker?
Sí, la aplicación tiene soporte para Podman. Necesitarás configurar el socket de Podman de manera similar al de Docker.
¿Qué diferencia hay entre Arcane y Dockge?
Ambas son alternativas modernas a Portainer. Dockge se enfoca específicamente en la gestión de stacks Docker Compose con edición visual de archivos YAML, mientras que esta plataforma ofrece una gestión más amplia de todos los recursos Docker con una interfaz más pulida.
¿Puedo usar Arcane Docker Compose en producción?
Sí, aunque el proyecto es relativamente joven, es estable y puede usarse en producción. Sin embargo, para entornos críticos, asegúrate de implementar todas las medidas de seguridad recomendadas como proxy inverso con SSL, socket proxy y autenticación robusta.
Conclusión
Arcane Docker Compose representa la nueva generación de herramientas de gestión de contenedores, combinando una interfaz moderna y responsive con funcionalidades avanzadas totalmente gratuitas. Si buscas una alternativa a Portainer que ofrezca mejor experiencia de usuario, soporte móvil nativo y sin restricciones empresariales, esta es tu mejor opción.
La instalación es sencilla, el mantenimiento mínimo y los beneficios inmediatos. Ya sea para tu homelab personal, entorno de desarrollo o servidor de producción, el gestor te proporcionará el control y visibilidad que necesitas sobre tus contenedores Docker.
Pruébalo hoy mismo siguiendo los pasos de instalación de esta guía y descubre por qué cada vez más administradores de sistemas están migrando a esta plataforma moderna y eficiente.
