Copias de seguridad
Qué guardar para poder recuperar KumoYami y cómo restaurarlo.
La imagen de KumoYami se puede volver a descargar en cualquier momento. Lo que es tuyo y hay que guardar está en la carpeta de la instalación:
| Qué | Contiene |
|---|---|
datos/ | Los almacenamientos del panel y sus credenciales, los tokens de OneDrive, el aspecto, los enlaces compartidos, la licencia activada… |
.env | Tus variables: ADMIN_PASSWORD, KUMOYAMI_PORT, tokens… |
docker-compose.yml | Con tus volúmenes y servicios. |
docker-compose.override.yml, Caddyfile | Si existen: Caddy del instalador, tu proxy o tus cambios. |
Las carpetas locales que publicas (tus fotos, documentos…) no están aquí: son tuyas y van en tu propia copia de seguridad.
Hacer la copia
En la carpeta de la instalación:
cd /opt/kumoyami
sudo tar czf ~/copia-kumoyami-$(date +%F).tgz .env docker-compose.yml datos/ \
$(ls docker-compose.override.yml Caddyfile 2>/dev/null)Para una copia del todo coherente, detén antes la web unos segundos (docker compose stop web) y arráncala después
(docker compose start web).
Guarda el archivo fuera del servidor: en tu ordenador (scp), en otro servidor o en un almacenamiento externo. El
.env y datos/ contienen contraseñas y tokens: trata la copia como algo privado.
Si pierdes datos/ sin copia, tendrás que volver a añadir los almacenamientos y conectar OneDrive.
Copia de seguridad del panel
El panel de administración tiene también su propia copia de seguridad de la configuración. Es cómoda para guardar los
ajustes, pero no sustituye a la copia de datos/ y del .env.
Restaurar
En un servidor con Docker y la sesión de docker login iniciada:
sudo mkdir -p /opt/kumoyami && cd /opt/kumoyami
sudo tar xzf ~/copia-kumoyami-2026-11-01.tgz
sudo chown -R 1000:1000 datos
sudo docker compose up -dSi restauras en otro servidor, sigue además Cambiar de servidor para la licencia.