Table of Contents
Application Tracker
Application Tracker is a self-hosted workspace for people who want one place to manage their job search.
GitHub Repository | Container Image
Overview
Application Tracker is designed for people who want more structure than a spreadsheet and more privacy than a hosted service. It helps you keep applications, company notes, follow-ups, documents, and progress history together in a single private dashboard.
What You Can Do
- Track applications: Keep role titles, companies, compensation notes, statuses, links, and next steps in one place.
- Organize company records: Save company-specific notes and see every related application in context.
- Manage documents: Attach files to applications so resumes, cover letters, and other materials stay easy to find.
- Follow your progress: Use the dashboard and activity history to understand what changed and what needs attention next.
- Customize your workflow: Use your own tags, source lists, and currencies instead of forcing everything into a fixed template.
Install from a Local Clone
Prerequisites: Docker 24+ and Docker Compose plugin.
After the containers start, open http://localhost:3000 and sign in with the
admin email and password you set in .env.
Install from GitHub Packages
If you prefer using the published container image instead of building locally, use the package published to GitHub Container Registry.
Before starting the published image, provide these environment variables directly in your deployment platform, compose file, or container configuration:
POSTGRES_USERPOSTGRES_PASSWORDPOSTGRES_DBAUTH_SECRETADMIN_EMAILADMIN_PASSWORDADMIN_NAMEMINIO_ROOT_USERMINIO_ROOT_PASSWORD
The supporting PostgreSQL and MinIO services should use the same values so the application, database, and object storage all start with matching credentials.
Technology Stack
- TypeScript / Next.js
- Prisma
- PostgreSQL
- MinIO (object storage)
- Docker Compose (orchestration)
- Playwright / Vitest (testing)