Setup

Docker Installation

Run Resume Matcher with Docker

Prerequisites

Install Docker Desktop (includes Docker Compose).

Quick Start

git clone https://github.com/srbhr/Resume-Matcher.git
cd Resume-Matcher
docker compose up -d

Open http://localhost:3000 for the UI. The API runs on port 8000.

Ports

ServicePortURL
Frontend3000http://localhost:3000
Backend API8000http://localhost:8000

Common Commands

# View logs
docker compose logs -f

# Stop containers
docker compose down

# Rebuild after code changes
docker compose build && docker compose up -d

# Update to latest
docker compose pull && docker compose up -d

Configuration

Create a .env file in the project root for API keys:

LLM_PROVIDER=openai
LLM_MODEL=gpt-4o-mini
LLM_API_KEY=sk-your-key-here

Or configure via the Settings page at http://localhost:3000/settings after starting.

Data Persistence

Resume data is stored in a Docker volume. To back up:

docker cp resume-matcher:/app/backend/data ./backup

Troubleshooting

Port 3000 already in use? Change the host port in docker-compose.yml: "3001:3000"

Container won’t start? Check logs: docker compose logs

Permission issues on Linux?

sudo chown -R $USER:$USER ./data

Next Steps