scripts/portainer-compose-stacks/BACKUPS/BACKUP-SUMMARY.md

Portainer Reset & Backup Summary

Date: November 18, 2025, 13:37 Issue: Portainer environments showing as "unreachable" due to stale configurations from previous multi-instance setup

Actions Taken

1. Complete Backup Created ✓

Location: /mnt/shared/DEV/repos/d-popov.com/scripts/portainer-compose-stacks/BACKUPS/20251118-133605/

Backup Contents:

• ✓ Portainer database (portainer-database-backup.db) - 512KB
• ✓ Portainer automatic backup (portainer-automatic-backup.db.bak) - 512KB
• ✓ All containers combined compose file (all-containers-compose.yml) - 17KB
• ✓ Individual container compose files (7 files):
  • container-portainer.yml
  • container-windows.yml
  • container-rincoin-node2.yml
  • container-amd-strix-halo-llama-rocm.yml
  • container-amd-strix-halo-llama-vulkan-radv.yml
  • container-amd-strix-halo-llama-vulkan-amdvlk.yml
  • container-docker-model-runner.yml

2. Portainer Database Reset ✓

• Old database: 512KB (contained stale environment 3)
• New database: 32KB (fresh installation)
• New instance ID: 1b059c79-d81d-4044-9050-4d90ea85a5ec
• Status: Running and responding correctly

3. Tools Installed ✓

• docker-autocompose from https://github.com/Red5d/docker-autocompose
• Dependencies: docker, pyaml Python packages

Next Steps for User

1. Initial Portainer Setup

Visit http://localhost:9000 and complete the initial setup:

• Create new admin username and password
• This is required since the database was reset

2. Add Docker Environment

After login, add your local Docker environment:

• Click "Get Started" or "Add Environment"
• Select "Docker" as environment type
• Choose "Socket" connection method
• Socket path: /var/run/docker.sock
• Name it "nuc" or "localhost"

3. Verify All Containers Are Visible

All your existing containers should appear automatically:

• portainer
• windows
• rincoin-node2
• amd-strix-halo-llama-rocm
• amd-strix-halo-llama-vulkan-radv
• amd-strix-halo-llama-vulkan-amdvlk
• docker-model-runner

4. Optional: Export Portainer Configuration

From the Portainer UI:

• Settings → Backup
• Download backup for safekeeping

Restore Instructions (If Needed)

To restore old Portainer database:

docker stop portainer
docker run --rm -v /mnt/data/docker_vol/portainer:/data \
  -v /mnt/shared/DEV/repos/d-popov.com/scripts/portainer-compose-stacks/BACKUPS/20251118-133605:/backup \
  alpine cp /backup/portainer-database-backup.db /data/portainer.db
docker start portainer

To restore containers from compose files:

cd /mnt/shared/DEV/repos/d-popov.com/scripts/portainer-compose-stacks/BACKUPS/20251118-133605

# Restore specific container
docker-compose -f container-NAME.yml up -d

# Or restore all containers
docker-compose -f all-containers-compose.yml up -d

Problem Resolution

The issue was caused by stale environment configurations (specifically "environment 3") remaining in the Portainer database even after removal from the UI. These corrupted entries caused Portainer to crash when attempting to connect to non-existent environments. A fresh database resolves this completely.