---
title: "Deploy freehire"
description: "Open-source job search engine: web, API, crawler, Meilisearch, Postgres"
category: "Other"
url: https://railway.com/deploy/freehire
---

# Deploy freehire

Open-source job search engine: web, API, crawler, Meilisearch, Postgres

**[Deploy freehire on Railway](https://railway.com/template/freehire)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/freehire/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### Worker https://raw.githubusercontent.com/strelov1/freehire/378e6899bf246531bb256e6cc819742603007838/web/static/apple-touch-icon.png

- **Source:** https://github.com/aalfath/freehire-railway-template

### Web https://raw.githubusercontent.com/strelov1/freehire/378e6899bf246531bb256e6cc819742603007838/web/static/apple-touch-icon.png

- **Source:** https://github.com/aalfath/freehire-railway-template
- **Health check:** /health
- **Public domain:** Yes

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

### API https://raw.githubusercontent.com/strelov1/freehire/378e6899bf246531bb256e6cc819742603007838/web/static/apple-touch-icon.png

- **Source:** https://github.com/aalfath/freehire-railway-template
- **Health check:** /health

### Meilisearch https://raw.githubusercontent.com/strelov1/freehire/378e6899bf246531bb256e6cc819742603007838/web/static/apple-touch-icon.png

- **Source:** https://github.com/aalfath/freehire-railway-template
- **Health check:** /health

### Redis https://cdn.sanity.io/images/sy1jschh/production/0ce0bfdcfbdbf69662b1116671f97c2dd788b655-157x157.svg

- **Image:** redis:8.2
- **Start command:** `/bin/sh -c "rm -rf $RAILWAY_VOLUME_MOUNT_PATH/lost+found/ && exec docker-entrypoint.sh redis-server --requirepass $REDIS_PASSWORD --save 60 1 --dir $RAILWAY_VOLUME_MOUNT_PATH"`

## Buckets

- **Bucket**

## Documentation

# Deploy and Host freehire on Railway

freehire is an open-source (MIT) job search engine. It crawls postings straight from job boards and company career sites, normalises and de-duplicates them, and serves faceted full-text search by region, work mode, seniority, skills and salary. On top it offers accounts, saved jobs, an application board, a CV builder and a public JSON API.

## About Hosting freehire

freehire is a Go API, a SvelteKit web app and a set of run-once workers that crawl sources and keep the search index current, backed by PostgreSQL with pgvector, Redis, Meilisearch and S3-compatible storage for CVs. This template wires all of it on Railway's private network: the web service is the only public one, the API applies its database migrations at start, and a worker service runs the crawl and indexing jobs in a loop (upstream runs them from cron). Secrets are generated at deploy time, Meilisearch keeps its index on a volume, and CVs go to a Railway bucket. The first jobs appear a few minutes after the deploy finishes.

## Common Use Cases

* Run your own job search site over public remote-job feeds, with search, filters and saved jobs
* Track your own applications and CVs on a private instance
* Build on a self-hosted job catalogue through freehire's keyless JSON API

## Dependencies for freehire Hosting

* PostgreSQL (Railway Postgres, which ships pgvector) for jobs, companies, users and the board catalogue
* Meilisearch for job, company and suggestion search; Redis for rate limiting and caches; a Railway bucket for CV files

### Deployment Dependencies

* freehire source and docs: https://github.com/strelov1/freehire
* Release this template builds: https://github.com/strelov1/freehire/releases/tag/deploy-20261119-1635
* Template repo (Dockerfiles, start scripts, changelog): https://github.com/aalfath/freehire-railway-template
* Meilisearch: https://www.meilisearch.com/docs

### Implementation Details

Services in this template:

* **Web** (public): SvelteKit SSR behind nginx. It serves the site and forwards `/api`, `/health` and `/cv` to the API over the private network, so sign-in cookies stay same-origin.
* **API**: the Go server. It applies pending migrations, then serves on port 8080. Health check: `/health`.
* **Worker**: registers the job sources in `INGEST_PROVIDERS` (by default remoteok, remotive, weworkremotely, himalayas, jobicy and workingnomads, which need no API key), creates the search indexes, then every `INGEST_INTERVAL_MINUTES` (60) crawls them and pushes new and closed postings into Meilisearch. It rebuilds the company index and search suggestions once a day.
* **Meilisearch** 1.49.0 (the version upstream runs), with its data on a volume and a generated master key.
* **Postgres**, **Redis** and a **Bucket** (Railway's own).

After deploy: open the Web service's domain and sign up. Accounts are open to anyone who can reach the site, and the first account has no special role. AI features (fit analysis, CV tailoring, the assistant), OAuth sign-in and e-mail are off until you set their variables on the API service (`LLM_BASE_URL`, `LLM_API_KEY`, `LLM_MODEL`; `OAUTH_GITHUB_CLIENT_ID`/`_SECRET` and similar). See upstream's `.env.example`. If you add a custom domain, set `FRONTEND_ORIGIN` on the API service to `https://YOUR-DOMAIN`.

Updates: the template builds from `aalfath/freehire-railway-template`, which pins upstream's release commit and every base image by digest. When we bump the version, Railway shows an update in your project; read `CHANGELOG.md` before you apply it.

## Why Deploy freehire on Railway?


Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying freehire on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.



## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/freehire
