Deploy freehire

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

Deploy freehire

/var/lib/postgresql/data

Just deployed

/meili_data

Just deployed

/data

Bucket

Bucket

Just deployed

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

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.


Template Content

More templates in this category

View Template
Rocky Linux
Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀

codestorm
51
View Template
Foundry Virtual Tabletop
Self-hosted virtual tabletop for role-playing games (license required)

Lucas
71
View Template
NEW
Double Commander in your browser
The Double Commander file manager in the cloud, from any device

Nermin Sabanovic
0