akanealw
eec8c28fb3
Some checks failed
Go Benchmark / Performance Regression Check (push) Has been cancelled
Cerberus Integration / Cerberus Security Stack Integration (push) Has been cancelled
Upload Coverage to Codecov / Backend Codecov Upload (push) Has been cancelled
Upload Coverage to Codecov / Frontend Codecov Upload (push) Has been cancelled
CodeQL - Analyze / CodeQL analysis (go) (push) Has been cancelled
CodeQL - Analyze / CodeQL analysis (javascript-typescript) (push) Has been cancelled
CrowdSec Integration / CrowdSec Bouncer Integration (push) Has been cancelled
Docker Build, Publish & Test / build-and-push (push) Has been cancelled
Quality Checks / Auth Route Protection Contract (push) Has been cancelled
Quality Checks / Codecov Trigger/Comment Parity Guard (push) Has been cancelled
Quality Checks / Backend (Go) (push) Has been cancelled
Quality Checks / Frontend (React) (push) Has been cancelled
Rate Limit integration / Rate Limiting Integration (push) Has been cancelled
Security Scan (PR) / Trivy Binary Scan (push) Has been cancelled
Supply Chain Verification (PR) / Verify Supply Chain (push) Has been cancelled
WAF integration / Coraza WAF Integration (push) Has been cancelled
Docker Build, Publish & Test / Security Scan PR Image (push) Has been cancelled
61 lines
1.7 KiB
Markdown
Executable File
61 lines
1.7 KiB
Markdown
Executable File
# Maintenance Documentation
|
|
|
|
This directory contains operational maintenance guides for keeping Charon running smoothly.
|
|
|
|
## Available Guides
|
|
|
|
### [GeoLite2 Database Checksum Update](geolite2-checksum-update.md)
|
|
|
|
**When to use:** Docker build fails with GeoLite2-Country.mmdb checksum mismatch
|
|
|
|
**Topics covered:**
|
|
|
|
- Automated weekly checksum verification workflow
|
|
- Manual checksum update procedures (5 minutes)
|
|
- Verification script for checking upstream changes
|
|
- Troubleshooting common checksum issues
|
|
- Alternative sources if upstream mirrors are unavailable
|
|
|
|
**Quick fix:**
|
|
|
|
```bash
|
|
# Download and update checksum automatically
|
|
NEW_CHECKSUM=$(curl -fsSL "https://github.com/P3TERX/GeoLite.mmdb/raw/download/GeoLite2-Country.mmdb" | sha256sum | cut -d' ' -f1)
|
|
sed -i "s/ARG GEOLITE2_COUNTRY_SHA256=.*/ARG GEOLITE2_COUNTRY_SHA256=${NEW_CHECKSUM}/" Dockerfile
|
|
docker build --no-cache -t test .
|
|
```
|
|
|
|
---
|
|
|
|
## Contributing
|
|
|
|
Found a maintenance issue not covered here? Please:
|
|
|
|
1. **Create an issue** describing the problem
|
|
2. **Document the solution** in a new guide
|
|
3. **Update this index** with a link to your guide
|
|
|
|
**Format:**
|
|
|
|
```markdown
|
|
### [Guide Title](filename.md)
|
|
|
|
**When to use:** Brief description of when this guide applies
|
|
|
|
**Topics covered:**
|
|
- List key topics
|
|
|
|
**Quick command:** (if applicable)
|
|
```
|
|
|
|
## Related Documentation
|
|
|
|
- **[Troubleshooting](../troubleshooting/)** — Common runtime issues and fixes
|
|
- **[Runbooks](../runbooks/)** — Emergency procedures and incident response
|
|
- **[Configuration](../configuration/)** — Setup and configuration guides
|
|
- **[Development](../development/)** — Developer environment and workflows
|
|
|
|
---
|
|
|
|
**Last Updated:** February 2, 2026
|