Harbor Registry

Harbor is the self-hosted container image registry at https://harbor.ayinza.dev. All SSERIS Docker images are stored here.

Access

Property	Value
URL	https://harbor.ayinza.dev
Login	Admin credentials (see stack YAML)
CLI login	docker login harbor.ayinza.dev

Projects

Images are organized into projects in Harbor. The main project is library.

# Pull an image
docker pull harbor.ayinza.dev/library/sseris-admin:latest

# Push an image
docker tag myimage:latest harbor.ayinza.dev/library/myimage:latest
docker push harbor.ayinza.dev/library/myimage:latest

Storage

Harbor stores images on Contabo at /data/. The total /data/ directory is 35 GB, with /data/registry accounting for nearly all of it (35 GB).

# Check Harbor disk usage
du -sh /data/registry
du -sh /data/database
du -sh /data/

Garbage Collection

Over time, deleted tags still consume disk space. Run garbage collection to reclaim:

1. Log into Harbor UI → Administration → Garbage Collection
2. Click GC Now (or schedule periodic GC)
3. Monitor the GC job in Job Service Dashboard

This will free up space from deleted/untagged images.

Harbor Architecture

Harbor runs as 9 separate Docker services (see Shared Services):

• Portal — web UI
• Core — API and authentication
• Registry — actual image storage (Docker Distribution)
• DB — PostgreSQL for Harbor metadata
• Redis — caching
• Job Service — async operations (GC, replication)
• Proxy — internal Nginx
• Registry Ctl — registry management
• Log — centralized logging

Troubleshooting

Can’t Push Images

1. Verify you’re logged in: docker login harbor.ayinza.dev
2. Check Harbor is healthy: visit the URL
3. Check disk space on Contabo: df -h
4. Check Harbor logs: docker service logs shared_core

Disk Full

1. Run garbage collection in Harbor UI
2. Delete old/unused image tags
3. Check /data/registry size: du -sh /data/registry