Resources / Marketing / OpenSEO setup guide (open-source Semrush alternative)
SE

OpenSEO setup guide (open-source Semrush alternative)

Start with OpenSEO's hosted version, or run it yourself with Docker and your own DataForSEO key. Costs, setup steps and the exact commands.

Sources checked 17 Nov 2026Browser, Docker, Cloudflare, Claude, ChatGPTMarketingIntermediate

What you’ll have at the end

Your own SEO tool for keyword research, rank tracking, competitor insights, backlinks, site audits and AI visibility, without a monthly Semrush or Ahrefs bill. Your AI (Claude, ChatGPT, Codex, Cursor) can also use it to do SEO work for you.

How this guide was made

Written from OpenSEO’s GitHub README and its docs (DataForSEO key, Docker self-hosting), read on 17 Nov 2026.

Which way should you use it?

Hosted (openseo.so)Self-hosted (your computer or server)
SetupSign up and goDocker or Cloudflare, about 30 min
Who pays DataForSEOOpenSEO bills you. It adds about 28% on top of DataForSEO’s priceYou pay DataForSEO directly
Monthly feeFree to try; $10/month if you want to support the projectNone
Best forBusiness owners trying it outAgencies and heavy users

Our suggestion: try the hosted version first. If you end up using it every week, self-hosting saves the extra 28%.

Option A: hosted (5 minutes)

  1. Sign up

    Go to openseo.so and create an account.

  2. Run your first search

    Type a keyword your customers would search for, like “dentist in Kochi”. Look at the volume and difficulty, and at who ranks right now.

Option B: self-hosted with Docker

This part is for technical users

You need Docker Desktop and some comfort with a terminal. If that’s new to you, stay on the hosted version.

  1. Get a DataForSEO API key

    Create an account at dataforseo.com and open API Access. Copy the credential labelled Base64. New accounts get $1 of free credit to test with. After that, the minimum top-up is $50.

  2. Install Docker Desktop

    Install Docker Desktop and give it at least 4 GB of memory in its settings.

  3. Download OpenSEO

    Open PowerShell (Windows) or Terminal (Mac) and run these one at a time:

    cd open-seo
    Windows (PowerShell):
    $env:COMPOSE_FILE = "deploy/standalone/compose.yaml"; copy deploy/standalone/.env.example deploy/standalone/.env
    Mac / Linux:
    export COMPOSE_FILE=deploy/standalone/compose.yaml && cp deploy/standalone/.env.example deploy/standalone/.env

  4. Add your keys

    Open deploy/standalone/.env in Notepad and set two values:

    • DATAFORSEO_API_KEY: paste the Base64 credential from step 1.
    • STORAGE_SECRET_KEY: any long random text. Treat it like a password.

    Leave BETTER_AUTH_URL=http://localhost:3001 as it is.

  5. Start it

    docker compose pull
    docker compose up -d
    docker compose logs -f init
    Wait until you see OpenSEO initialized and ready.

  6. Create your admin account

    Open http://localhost:3001 and create the first account. That account becomes the admin, and sign-up closes after it. Invite teammates from Team settings.

Run it on the web for free

OpenSEO can also be deployed to your own Cloudflare account with one command (it works on the free plan). See docs/SELF_HOSTING_CLOUDFLARE.md in the repo.

Connect Claude or ChatGPT

OpenSEO has an MCP server and ready-made Agent Skills. Follow the official setup pages on openseo.so/docs for ChatGPT, Codex or MCP. Then you can ask, for example:

Using OpenSEO, find 20 low-competition keywords for a bakery in Kochi and group them by search intent.

Costs at a glance

  • Software: free (MIT licence).
  • SEO data: pay-as-you-go to DataForSEO, starting with $1 free credit and then a $50 minimum top-up.
  • Optional extras: AI summaries need an OpenRouter key, and JavaScript-rendered site audits need a rendering key. Both are paid per use.

Back to the full list: 4 open-source alternatives to paid AI tools