Tarnished documentation

Tarnished is a self-hosted job application tracker for managing applications, job leads, documents, interview rounds, analytics, imports, exports, and automation on your own infrastructure.

Start here

Install Tarnished

Choose the install path that matches your environment:

• Install with Docker Compose — the fastest way to get Tarnished running
• Install with PostgreSQL Docker Compose — start with PostgreSQL from day one
• Install with Helm — run Tarnished on Kubernetes

Get started in Tarnished

Once the app is running, start with these first-use guides:

• Create your admin account
• Create your first application
• Create your first API key

Popular tasks

Use these guides once Tarnished is already installed:

• Configure API keys
• Use the CLI
• Use the browser extension
• Import and export data
• Back up and restore Tarnished
• Upgrade Tarnished
• Configure AI settings

Need deeper detail?

• Use Reference for exact environment variables and API surfaces.
• Use Explanation for architecture, storage, auth, and transfer-job rationale.
• Use Troubleshooting when Tarnished does not start or does not behave the way you expect.

Contributor docs

Contributor-facing docs live separately under Contributing so the main user path stays focused on installing, using, and operating Tarnished.