godocs
Demo snapshot — try the live demo
A lightweight Electronic Document Management System (EDMS) for home users, built entirely in Go.
Originally created by deranjer/godocs — hard fork with significant modernization.
What is godocs?
A self-hosted document management system for scanning, organizing, and searching receipts, documents, and other files. Focused on simplicity, speed, and reliability over enterprise complexity.
Quick Install
go install github.com/drummonds/godocs@latest
godocs
Starts with pglike (SQLite via go-postgres) — no external database needed.
Key Design Principles
- Easy Setup — works out-of-the-box, no dependencies for basic use
- Pure Go — single binary with embedded static assets
- Full-Text Search — PostgreSQL tsvector or SQLite fallback
- Step-Based Ingestion — hash, deduplicate, OCR, index
- Multiple Formats — PDF, images (TIFF, JPG, PNG), text files
Major Improvements in This Fork
- Go 1.22+ with structured logging (slog)
- SSR frontend using lofigui + pongo2 templates + Bulma CSS
- Pure Go PDF rendering (no CGo required)
- PostgreSQL full-text search with word cloud visualization
- Step-based ingestion with job tracking
- Canonical file naming with sidecar files (.ocr.txt, .thumb.png, .tags.json)
Documentation
Full documentation: drummonds.github.io/godocs
- Getting Started — configuration, environment variables
- Development — building, testing, deployment
- API Reference — OpenAPI / Swagger
- Internal Docs — file naming, tagging, lifecycle
Links
| Documentation | https://h3-godocs.statichost.page/ |
| Source (Codeberg) | https://codeberg.org/hum3/godocs |
| Mirror (GitHub) | https://github.com/drummonds/godocs |
| Docs repo | https://codeberg.org/hum3/godocs-docs |
License
See LICENSE file.