Backup

La carpeta de CertGuardian se suele almacenar en la home del usuario que instaló CertGuardian: Por ejemplo:

/home/<user>/certguardian-docker-images

Puedes ver la home del usuario con el que estás conectado con:

echo $HOME

La carpeta de CertGuardian se suele llamar certguardian-docker-images.

Antes de hacer el backup, asegúruate the estar en la carpeta de CertGuardian

Comprueba las versiones de CertGuardian y Backoffice

Antes de hacer el backup, guarda las versiones actuales de CertGuardian y Backoffice:

printf 'Certguardian version: %s\n' "$(docker inspect --format '{{ index .Config.Labels "certguardian.version" }}' gitea.entorno.es:3000/certguardian/certguardian:latest)" > certguardian_version
printf 'Backoffice version: %s\n' "$(docker inspect --format '{{ index .Config.Labels "certguardian.backoffice.version" }}' gitea.entorno.es:3000/certguardian/certguardian-backoffice:latest)" >> certguardian_version
docker image inspect redis:alpine   --format '{{range .Config.Env}}{{if eq (index (split . "=") 0) "REDIS_VERSION"}}{{println .}}{{end}}{{end}}' >> certguardian_version

El comando anterior crear el fichero certguardian_version que contiene las versiones actuales.

Certguardian version: v0.12.4
Backoffice version: v0.6.3
REDIS_VERSION=8.10.2

Backup de la carpeta

Después de guardar las versiones actuales, haz una copia (o cómprimela en un zip) de la carpeta certguardian-docker-images y muévela en la ubicación designada para los backups.
Ejemplo:

tar -czf "certguardian-docker-images_$(date +%Y%m%d_%H%M).zip" ./certguardian-docker-images
cp "certguardian-docker-images_$(date +%Y%m%d_%H%M).zip" /destino/backup

Restaurar backup

Para restaura el backup de CertGuardian, sigue los siguientes pasos.

Apaga los contenedores de CertGuardian

Navega a la carpeta original de CertGuardian y ejectua:

docker compose down

Restaura la carpeta de CertGuardian

Restaura la carpeta de CertGuardian de tu backup

tar -xzf certguardian-docker-images.zip -C ./certguardian-docker-images_restored

Navega al directorio restaurado.

Comprueba la versión de CertGuardian

Si quieres restaurar el backup con la misma versión de certguardian de cuando se hizo el backup, comprueba las version en el fichero certguardian_version:

cat certguardian_version

Apunta las versiones.

Actualiza las versiones de la imagen de Docker

Abre el fichero docker-compose.yml y busca los servicios de certguardian y ``backoffice`.

  backoffice:
    restart: unless-stopped
    image: gitea.entorno.es:3000/certguardian/certguardian-backoffice:latest
    container_name: certguardian_backoffice
    volumes:
      - ./backoffice/config.js:/usr/share/nginx/html/config.js
    depends_on:
      - certguardian
  certguardian:
    image: gitea.entorno.es:3000/certguardian/certguardian:latest
    volumes:
      - ./backend/logs:/var/www/certguardian/storage/logs
      - ./backend/certificates:/certguardian/certificates
      - ./backend/data/:/data
      - ./backend/.ssh:/var/www/certguardian/ssh-keys
    container_name: certguardian_backend
    restart: unless-stopped

Reemplaza latest con las versiones obtenidas del fichero certguardian_version.

Descarga las imágenes de Docker

Run:

docker compose pull

Esto descarga la versión específicada en las imágenes de Docker

Recrea los contenedores

The run:

docker compose up --force-recreate

Comprueba los logs

Después de restaurar CertGuardian, revisa los logs:

docker compose logs

Si CertGuardina ha arrancado correctamente, deberías ver algo parecido a esto:

certguardian-1  | ### Running all services ###
certguardian-1  | 2026-09-29 09:14:19,053 INFO supervisord started with pid 1
certguardian-1  | 2026-09-29 09:14:20,054 INFO spawned: 'apache2' with pid 149
certguardian-1  | 2026-09-29 09:14:20,057 INFO spawned: 'reverb' with pid 150
certguardian-1  | 2026-09-29 09:14:20,058 INFO spawned: 'scheduler' with pid 151
certguardian-1  | 2026-09-29 09:14:20,059 INFO spawned: 'worker' with pid 152
certguardian-1  | 2026-09-29 09:14:21,344 INFO success: apache2 entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)
certguardian-1  | 2026-09-29 09:14:21,344 INFO success: reverb entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)
certguardian-1  | 2026-09-29 09:14:21,344 INFO success: scheduler entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)
certguardian-1  | 2026-09-29 09:14:21,344 INFO success: worker entered RUNNING state, process has stayed up for > than 1 seconds (startsecs)