Deploy and Host self hosted OpenSEO Keywords (Open-Source Keyword Research Tool) on Railway

This template runs a private OpenSEO instance behind a password gateway, so you can do keyword research on your own server.

About Hosting OpenSEO Keywords open-source software on Railway (self hosted OpenSEO keyword research template)

This template runs the open source OpenSEO app (image ghcr.io/every-app/open-seo) on your own Railway project, with a small Caddy gateway in front that asks for a username and password.

Why Deploy OpenSEO Keywords, the Semrush Keyword Magic Tool alternative on Railway (Railway Free Trial)

Semrush Keyword Magic Tool lives in a closed SaaS suite with a monthly subscription, so you pay whether you run ten lookups or ten thousand.

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 OpenSEO Keywords 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.

Railway vs Other Hosting Providers and VPS for OpenSEO Keywords self hosting

Railway deploys both OpenSEO services from one template, with the login and volume already wired up. Here is how that compares with a raw VPS.

Provider	What You Get with Railway	What You Get with the Other Provider
DigitalOcean	Both services deployed from a template, with the gateway password and data volume handled.	A droplet you configure yourself, including Docker, the login proxy and TLS.
AWS	A pay-as-you-go deploy with no VPC or load balancer to design first.	Full control over instances and networking, and you own all the upkeep.
Hetzner	A managed deploy that skips the SSH session and hand-written firewall rules.	Low-cost servers where you install Docker, lock down the port and patch it yourself.

Choose the VPS route if you already maintain a machine you want to run OpenSEO on.

Common Use Cases for hosted OpenSEO Keywords

Finding long-tail keywords for a new post: Start with a seed like "self hosted analytics" and pull related phrases with volume and difficulty. Pick the ones small enough for a young site to rank for.
Checking search volume before you write: Run the seed through keyword metrics first so you know whether the topic is worth a full article. Each lookup costs a fraction of a cent through DataForSEO, so checking every idea is affordable.
Keyword clustering for content plans: Export a batch of related terms and group them by intent. A messy list becomes a month of articles, each targeting its own cluster.
Comparing keyword data across markets: Pass a local location name to see city or regional volume next to national figures. Keyword ideas and difficulty stay national, so use local volume only for demand.
Pay-per-use research for agencies: Run one shared instance for the team and pay DataForSEO only for the lookups clients need. There is no per-seat subscription to justify when only a few people research in a given month.

Dependencies for OpenSEO Keywords Docker hosted on Railway

This template runs two services, and only one of them is reachable from the internet.

Deployment Dependencies for Managed OpenSEO Keywords Service (SEO Tool)

OpenSEO service: image ghcr.io/every-app/open-seo:v0.1.13, private only, port 3001, health check at /api/health, with a volume mounted at /app/.wrangler for the database.
Gateway service: image caddy:2.11.7-alpine, the only public service, port 8080, health check at /healthz, HTTP basic auth with username admin.
DataForSEO account: a pay-per-use API login. Set DATAFORSEO_API_KEY to the base64 of login:API password, not the dashboard key.

Implementation Details for OpenSEO Keywords (Using OpenSEO official docker image)

The OpenSEO image builds the app on first boot, which takes about 1-2 minutes, and the gateway shows a starting page until it finishes.

printf 'you@example.com:API_PASSWORD' | base64

How does OpenSEO Keywords compare against other keyword research tools

OpenSEO Keywords vs Semrush Keyword Magic Tool (Semrush Alternative)

Data source: OpenSEO pulls keyword volume, difficulty, intent and CPC from DataForSEO, so you pay per request and skip the monthly seat. Semrush runs on its own proprietary database inside a closed subscription.
Hosting: You run OpenSEO on your own server, and your keyword lists stay in your own volume. Semrush keeps everything in its cloud.
Breadth: Semrush wins on breadth. Its database, reports and suite around keyword research are far larger than what OpenSEO covers.

OpenSEO Keywords vs Ahrefs Keywords Explorer (Ahrefs Alternative)

Cost model: You pay DataForSEO for each lookup rather than a recurring Ahrefs plan, which suits sporadic research better.
Control: The MIT-licensed code is yours to inspect and modify. Ahrefs is a closed SaaS product.
Index depth: Ahrefs has its own large index and is usually stronger for competitor backlink and keyword gap work.

OpenSEO Keywords vs Google Keyword Planner (Google Keyword Planner Alternative)

Volume precision: Keyword Planner shows bucketed volume meant for ad campaigns. OpenSEO returns numeric monthly volume along with difficulty and intent.
Difficulty and intent: Google Keyword Planner gives no keyword difficulty score. OpenSEO adds one for countries DataForSEO Labs covers.
Price: Keyword Planner is free and Google-hosted. It is the better starting point if you only need rough ad-style numbers.

OpenSEO Keywords vs Ubersuggest (Ubersuggest Alternative)

Ownership: Ubersuggest is a hosted SaaS product from a single vendor. OpenSEO runs as an app on your own Railway project.
Data pipeline: OpenSEO's numbers come from DataForSEO's API, so you can see exactly what each lookup costs. Ubersuggest bundles its data into its plan.
Ease of use: Ubersuggest has a polished interface that needs no setup. OpenSEO requires deploying the stack and adding a DataForSEO credential first.

How to use OpenSEO Keywords (the OSS SEO platform)?

Log in. Open your gateway URL and sign in as admin with the OPENSEO_PASSWORD value from the Gateway Variables tab.
Add your DataForSEO credentials. Set DATAFORSEO_API_KEY on the OpenSEO service to the Base64 of your login and API password, not the dashboard key:

printf 'you@example.com:API_PASSWORD' | base64

Check the connection. Load https://your-domain/api/health and confirm dataforseo reads ok.
Open keyword research. Pick the keyword research workflow from the main menu.
Enter a seed and location. Type one to five seed keywords and choose a country, or a local location for city-level volume.
Review volume and related keywords. Check volume, difficulty, intent and CPC, then scan related keywords for long-tail ideas.
Save to a project. Keep the keywords you want so you can return to them when planning content.

How to self host OpenSEO Keywords on other VPS Services (OpenSEO self hosting guide)

This guide covers a plain Docker setup on any Linux VPS.

Clone the Repository

SSH into your server and clone the upstream project:

git clone https://github.com/every-app/open-seo.git
cd open-seo

Install Dependencies

You need Docker and the Compose plugin on the host.

docker --version
docker compose version

Configure Environment Variables

Copy the example file and set your DataForSEO credential and hostname.

cp .env.example .env
printf 'you@example.com:API_PASSWORD' | base64

Put that output in DATAFORSEO_API_KEY, and set ALLOWED_HOST to your-domain. Keep the port private to your reverse proxy or VPN.

Start the OpenSEO Keywords Application

Bring the stack up and check the health endpoint:

docker compose up -d
curl https://your-domain/api/health

The first boot takes one to two minutes while the app builds.

Official Pricing of OpenSEO Keywords (OpenSEO pricing)

OpenSEO itself is free and open source under the MIT license, so self hosting costs you nothing in software fees.

OpenSEO Keywords cloud vs self hosted comparison (Pricing, features, costs, and more)

Self hosting OpenSEO Keywords and using the hosted openseo.so version do the same keyword research, but the bill looks different.

Monthly cost of self hosting OpenSEO Keywords on Railway

Self hosting is free, so your monthly cost is the Railway bill for the two services plus DataForSEO usage.

System Requirements for Hosting OpenSEO Keywords on a VPS

OpenSEO builds itself at boot on Node 22 plus workerd, and memory peaks near 4 GB during that build before settling around 0.7 GB while idle.

Frequently Asked Questions (FAQs)

Where does the keyword data come from?

OpenSEO pulls search volume, keyword difficulty, intent, and CPC from DataForSEO, and you pay DataForSEO directly per request.

How much does each keyword lookup cost?

Cost depends on how many keywords a call returns and whether you turn on clickstream refinement, which doubles the request cost.

Can I research keywords for a specific city or country?

Yes. Keyword ideas, difficulty, and intent stay national, and some countries are served without difficulty or intent data.

Can I save keyword lists and group them into clusters?

Yes. Save keywords to a project so each list stays with the site it belongs to, then group related terms into clusters for your content plan.

How does it compare with Semrush Keyword Magic Tool data?

OpenSEO uses DataForSEO's data, while Semrush runs its own large proprietary database, so the numbers will not match exactly.