Skip to content

Hafiz Documentation

Troubleshooting

Troubleshooting¶

Common Issues¶

Connection Refused¶

# Check if service is running
systemctl status hafiz

# Check port binding
ss -tlnp | grep 9000

Authentication Failed¶

# Verify credentials
echo $HAFIZ_ROOT_ACCESS_KEY
echo $HAFIZ_ROOT_SECRET_KEY

# Check signature
aws --endpoint-url http://localhost:9000 s3 ls --debug

Database Connection¶

# Test PostgreSQL
psql -h localhost -U hafiz -d hafiz -c "SELECT 1"

# Check connection string
echo $HAFIZ_DATABASE_URL

Disk Full¶

# Check disk space
df -h /data

# Find large objects
hafiz du -H s3://

Logs¶

Docker¶

docker logs hafiz
docker logs -f hafiz  # Follow

Kubernetes¶

kubectl logs -f deployment/hafiz -n hafiz

Systemd¶

journalctl -u hafiz -f

Debug Mode¶

HAFIZ_LOG_LEVEL=debug hafiz-server

Getting Help¶