Setup

Docker Installation

Run Resume Matcher with the default Docker setup

Prerequisites

Install Docker Desktop or a current Docker Engine + Docker Compose setup.

Quick Start

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

The checked-in Docker flow exposes Resume Matcher on a single public origin.

Default URLs

SurfaceURL
Apphttp://localhost:3000
Settingshttp://localhost:3000/settings
Healthhttp://localhost:3000/api/v1/health
API docshttp://localhost:3000/docs

In the default Docker setup, the UI and public API routes are served from the same origin.

Common Commands

docker compose up -d
docker compose logs -f
docker compose down

Change the Public Port

Use the PORT environment variable instead of editing the compose file:

PORT=4000 docker compose up -d

Then use:

  • http://localhost:4000
  • http://localhost:4000/settings
  • http://localhost:4000/api/v1/health
  • http://localhost:4000/docs

Provider Configuration

After the containers are up, open Settings and choose your provider:

  • OpenAI
  • Anthropic
  • OpenRouter
  • Google Gemini
  • DeepSeek
  • Ollama

For local-model usage, follow Docker + Ollama.

Troubleshooting

The app does not load

Check logs:

docker compose logs -f

You changed the port

Route all app, settings, health, and docs URLs through the same public port.

Next Steps