Troubleshooting

Common Issues

Service Not Accessible

# 1. Check if container is running
task ps

# 2. Check container health
task health

# 3. Check Traefik routes
cd /opt/services && task routes

# 4. Check service logs
task logs:npm    # or docker, maven, pypi

Authelia Redirect Loop

• Verify the service domain matches an access control rule in Authelia config
• Check Authelia cookie domain covers *.registry.hochguertel.work
• Ensure Authelia is running: cd /opt/services && task authelia:health

Docker Login Fails

# Check token server health
podman exec registry-docker-token-server python -c \
  "import urllib.request; print(urllib.request.urlopen('http://127.0.0.1:5001/health').read())"

# Check token server logs
task logs:docker

# Verify user exists in Authelia
cat /opt/services/authelia/users_database.yml

Maven/Gradle Cannot Resolve Dependencies

1. Verify Reposilite is running: curl -sf https://maven.registry.hochguertel.work/api/status/instance
2. Check your settings.xml has correct server ID and credentials
3. Ensure the repository exists in Reposilite (create via web UI)

pip Install Fails

1. Verify DevPI is running: curl -sf https://pypi.registry.hochguertel.work/+api
2. Check the index URL includes /+simple/ suffix
3. Verify the package exists: devpi list mypackage

Container Won't Start

# Check for port conflicts
podman ps -a --format "table {{.Names}}\t{{.Ports}}"

# Validate compose
cd /opt/services/registries && podman-compose config

# Check disk space
df -h /opt/services/registries/data/

Health Check Commands

# All services at once
task ping

# Individual services
curl -sf https://npm.registry.hochguertel.work/-/ping
curl -sf -o /dev/null -w "%{http_code}" https://docker.registry.hochguertel.work/v2/
curl -sf https://maven.registry.hochguertel.work/api/status/instance
curl -sf https://pypi.registry.hochguertel.work/+api

Logs

# All logs
task logs

# Per-service
task logs:npm
task logs:docker
task logs:maven
task logs:pypi

Reset a Service

# Stop and remove containers + data
task down:npm
rm -rf data/npm/storage/*
task up:npm

⚠️ This destroys all packages in the registry. Back up first!