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
| Service | Port | URL |
|---|---|---|
| Frontend | 3000 | http://localhost:3000 |
| Backend API | 8000 | http://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
- Docker + Ollama - Run AI locally
- Features - What you can do