JobSync

Track every application, get AI resume reviews and job matches, and discover new openings automatically — free, open source, and your data never leaves your server.

🔒 Self-hosted · 🤖 Local AI via Ollama or any cloud provider · 🔌 MCP server for Claude Desktop, Hermes, etc

⭐ If JobSync helps your search, a star helps other job seekers find it.

Why JobSync?

• One place for your whole search: applications, resumes, contacts, interviews, tasks and AI help in a single source of truth, instead of scattered spreadsheets, notes and tabs.
• Free forever: no subscription and no paywalled tiers.
• Private: self-hosted, so your resumes and applications stay on your own server.
• Local AI, no API costs: run models on your own machine with Ollama, or bring a cloud provider key.

Key Features

• Application Tracker: Record every application with its company, title, dates and current status.

• Monitoring Dashboard: See your search progress, activity and daily goals at a glance.

• Resume Management: Store resumes, export them as PDFs, and import existing PDF or Word files with AI.

• Automated Job Discovery: Schedule searches over company job boards and AI-match each listing to your resume. Details

• Task & Activity Management: Track tasks and time your activities. Tasks · Activities

• Job Timeline: Record each stage of a job's hiring process — when it happened, who interviewed you and which questions they asked. Details

• Interviews: One list of every interview round across all your jobs, upcoming and past, with its interviewers, prep questions and outcome. Details

• Contacts: Keep recruiters, interviewers and references, linked to the jobs they touched. Details

• Company Pages: One page per company with its jobs, people and links, plus a watchlist. Details

• Question Bank: Build a library of interview questions and answers, tagged by skill.

• Data Backup & Restore: Export everything as one zip, import it anywhere, and undo an import. Details

• AI Assistant: A docked chat that reviews resumes, scores job matches, writes cover letters and adds jobs you paste in. Details

• AI Agent Integration (MCP): Add jobs and questions from Claude Desktop and other agents. Details

Quick Start

Make sure Docker is installed and running, then:

git clone https://github.com/Gsync/jobsync.git
cd jobsync
docker compose up

Note: The first startup downloads the prebuilt app image, so give it a moment before opening the browser.

Open http://localhost:3737 and create your account. That's it!

API keys for AI providers can be configured in Settings after signing in.

Configuration (Optional)

Environment variables are set in a .env file beside docker-compose.yml (copy .env.example). Do not edit docker-compose.yml itself — updates replace it.

Variable	Description
TZ	Your timezone (e.g. America/Edmonton). Set this on remote servers to avoid activity time shifts.
AUTH_SECRET	Auto-generated if not set. To set manually: openssl rand -base64 32
ENCRYPTION_KEY	Encrypts the API keys you save in Settings. Set your own (openssl rand -base64 32) before adding any keys, and never change it afterwards — a new value makes every stored API key unrecoverable.
NEXTAUTH_URL	The address you open JobSync at. Defaults to http://localhost:3737; on a homelab server, use the server's IP or hostname.
MCP_ENABLED	Set to false to turn off the MCP server. Enabled by default.
DATABASE_URL	Leave unset to use the bundled Postgres. To use your own, set it to your server's address and also set BUNDLED_DB=0; without it an unused bundled database container still starts. The bundled image includes the pgvector extension, which an upcoming release uses for resume embeddings; your own server will need it then too. See Upgrading to Postgres.

Updating

Upgrading from a SQLite release? Read Upgrading to Postgres first — the upgrade is one-way.

From the project directory, run the deploy script to pull the latest image and restart:

curl -fsSL https://raw.githubusercontent.com/Gsync/jobsync/main/deploy.sh | sudo bash -s

On Windows, run the PowerShell equivalent from the project directory instead (deploy.sh needs WSL or Git Bash; deploy.ps1 runs natively):

.\deploy.ps1

Note: If you are updating in a homelab environment, edit NEXTAUTH_URL in your .env file to use your server IP address instead of localhost. See .env.example for the expected format.

Features in Detail

AI Assistant (In-App Chat)

All of JobSync's AI features live in one place: a chat panel that docks to the side of the app instead of taking it over, so the page you were on stays visible and usable while the assistant works.

Open it from the AI Assistant button in the header, or let the app open it for you — the Review button on a resume and the Match with AI and Cover Letter buttons on a job all start the matching request in the panel.

What you can ask for:

This is the beginning of the README. Read the rest at the original. Read the full README ↗