manatactical/forgejo-report-tool
Privacy-first bug and feature report tool for Forgejo-hosted projects.
164
manatactical/forgejo-report-tool repository overview
🔒 Forgejo Anonymous Report Tool
Privacy-first bug and feature report tool for Forgejo-hosted projects
Users submit reports without a Forgejo account. API token stays server-side.
Configuration
Environment Variables (Server)
| Variable | Required | Default | Purpose |
|---|---|---|---|
FRT_apiURL | Yes | — | Forgejo API base URL |
FRT_token | Yes | — | Forgejo API token (server-side only) |
FRT_owner | Yes | — | Repository owner |
FRT_repo | Yes | — | Repository name |
FRT_siteName | No | Anonymous Report Tool | UI header and browser tab name |
FRT_accessPassword | No | — | Password gate for report access |
FRT_accessCookieName | No | — | Cookie name for webview bypass (requires FRT_accessCookieValue) |
FRT_accessCookieValue | No | — | Expected cookie value (shared secret) for webview bypass |
FRT_logoPath | No | custom/logo.png | Custom logo image path |
PORT | No | 3001 | Server port |
Frontend Labels (src/environments/environment.ts)
export const appConfig = {
bugLabel: 'kind/bug',
featureLabel: 'kind/feature',
enhancementLabel: 'kind/enhancement',
criticalLabel: 'critical',
criticalPriorityLabel: 'priority/critical',
};
Repo in Forgejo must use "Advanced Label Set" to fully enjoy this tool.
Custom Config File (custom/config.json)
Editable file mounted at runtime. No rebuild needed.
{
"features": {
"categories": [
{ "name": "General", "features": ["User Interface", "Performance", "Accessibility"] },
{ "name": "Authentication", "features": ["Login", "Registration", "Password Reset"] }
]
},
"typeFilter": {
"enabled": true,
"types": { "bug": true, "feature": true, "enhancement": true }
}
}
Custom Logo
Place logo.png in custom/. Served at /api/logo without auth.
Deployment
Docker
Requires connection to the same Docker network as Forgejo. The example below uses the external network forgejo_forgejo (created by Forgejo's docker-compose). Within this shared network, Forgejo is reachable via its service/container hostname (e.g. http://forgejo:3000).
docker build -t forgejo-report-tool .
docker run -d --restart unless-stopped \
--name forgejo-report-tool \
-p 3001:3001 \
--network forgejo_forgejo \
-e FRT_apiURL=http://forgejo:3000/api/v1 \
-e FRT_token=your_token \
-e FRT_owner=your_org \
-e FRT_repo=your_repo \
-v $(pwd)/custom:/app/custom \
forgejo-report-tool
Mount custom/ volume to override config and logo without rebuild.
API Endpoints
| Method | Path | Purpose |
|---|---|---|
| GET | /api/config | Site name and subtitle |
| GET | /api/custom-config | Feature list and type filters |
| GET | /api/logo | Custom logo image |
| GET | /api/access | Session auth |
| POST | /api/logout | Invalidate session |
| POST | /api/proxy | Proxy Forgejo API requests |
Tag summary
Content type
Image
Digest
sha256:fdafba5e6…
Size
55 MB
Last updated
5 months ago
docker pull manatactical/forgejo-report-tool