Crédito donde se merece

Antes de empezar, quiero darle crédito al video que usé pa' configurar mi NAS desde cero. Si están comenzando con el Ugreen 4800 Plus, este video les va a ahorrar un montón de tiempo:

📺 Ver video en YouTube →

Gracias al creador de ese video — lo explica bien claro y fue lo primero que busqué cuando saqué el NAS de la caja.

¿Qué es Portainer?

Portainer es una interfaz web de código abierto que te permite gestionar contenedores Docker de forma visual, sin tener que escribir comandos en la terminal. Desde el navegador puedes crear, detener, actualizar y monitorear todos tus contenedores.

Para los que estamos comenzando con el self-hosting en el Ugreen 4800 Plus, Portainer es prácticamente imprescindible. Fue lo primero que instalé y desde entonces gestiono todo desde ahí — Nextcloud, Vaultwarden, y muchos servicios más.

Requisitos previos

  • Ugreen NASync DXP4800 Plus con UGOS Pro actualizado
  • Acceso a la interfaz web de UGOS Pro
  • La app de Docker instalada desde el App Center de UGOS

No necesitan SSH. Todo se hace desde la interfaz gráfica de UGOS Pro.

Paso 1: Instalar Docker desde el App Center

Si todavía no tienen Docker instalado en el NAS, abran el App Center de UGOS Pro, busquen "Docker" y denle a Instalar. Una vez instalado, ábralo desde el menú principal.

Paso 2: Verificar permisos de la carpeta Docker

Antes de crear nada, asegúrense de que la carpeta docker en el Volumen 1 tenga permisos de Lectura y Escritura. Pueden verificarlo desde el Administrador de Archivos → clic derecho sobre la carpeta docker → Propiedades → Permisos.

Paso 3: Crear la carpeta de datos de Portainer

Dentro de la app Docker en UGOS Pro, vayan al Administrador de Archivos y naveguen hasta la carpeta docker. Creen una carpeta nueva y nómbrenla exactamente portainer (todo en minúsculas).

Esta carpeta va a guardar toda la configuración de Portainer — contraseñas, stacks, configuración de entorno. Nunca la borren aunque vayan a actualizar Portainer.

Paso 4: Crear el proyecto en Docker

En la app de Docker, busquen en el panel izquierdo la opción Proyecto y denle a Crear.

  1. En el campo Nombre del proyecto escriban: portainer
  2. Denle clic a Ruta de almacenamiento
  3. Seleccionen la carpeta portainer que crearon en el paso anterior y confirmen

Paso 5: Pegar la configuración Docker Compose

En el área de Configuración Compose, borren cualquier texto que haya por defecto y peguen esto:

version: '3'
services:
  portainer:
    image: portainer/portainer-ce:latest
    container_name: portainer
    restart: always
    ports:
      - "8000:8000"
      - "9000:9000"
      - "9443:9443"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /volume1/docker/portainer:/data

El parámetro restart: always es clave — garantiza que Portainer arranque solo cada vez que el NAS se reinicie.

Paso 6: Desplegar el contenedor

Activen la opción "Ejecutar inmediatamente después de la creación" y denle a Desplegar. UGOS va a bajar la imagen de Portainer de Docker Hub y levantará el contenedor automáticamente. Dependiendo de la velocidad de internet puede tardar entre 30 segundos y un par de minutos.

Acceder a Portainer por primera vez

Abran el navegador y entren a:

http://IP-DE-SU-NAS:9000

La primera vez les va a pedir que creen una cuenta de administrador. Elijan un nombre de usuario y una contraseña bien segura. Después de eso:

  1. Denle a Get Started para usar el entorno local
  2. En la pantalla de Environments, denle clic al ícono de lápiz (editar)
  3. En el campo Public IP, escriban la IP local de su NAS (ejemplo: 192.168.1.100)
  4. Denle a Update environment — verán el mensaje "Environment updated" arriba a la derecha
  5. Denle a Live connect para entrar al dashboard

¿Cómo actualizar Portainer en el futuro?

Como instalaron Portainer como un proyecto en Docker, actualizar es bien sencillo. Vayan a Docker → Proyecto → seleccionen portainer → los tres puntitos → Configuración → pestaña "Configuración Compose" → Redeploy. UGOS va a bajar la imagen más reciente y reiniciar el contenedor automáticamente, sin perder ninguna configuración.

Mi experiencia personal

Llevo varios meses usando Portainer en mi Ugreen 4800 Plus y es el punto de partida de todo mi stack de self-hosting. La interfaz es clara, los logs están a un clic de distancia, y cuando algo se rompe a las 2 AM (porque siempre pasa en el peor momento), es mil veces más fácil diagnosticarlo desde ahí que estar buscando comandos en la terminal.

Si van comenzando con el NAS, instalen esto primero. Todo lo demás — Nextcloud, Vaultwarden, Tailscale — se gestiona mucho más fácil desde Portainer.