Deploy DonSeTch

Keyless web search, fetch and crawl MCP server for AI agents

Deploy DonSeTch

Just deployed

/data

Deploy and Host self hosted DonSeTch (AI/ML) on Railway

This template deploys DonSeTch, an independent community packaging of the AGPL-3.0 web access MCP server, as one always-on service behind a bearer-token URL.

About Hosting DonSeTch open-source software on Railway (self hosted DonSeTch template)

This template runs the unmodified DonSeTch v5.5.4 Linux release binary, checked against its published SHA256, inside a single donsetch service started in HTTP mode on port 8080.

Why Deploy DonSeTch, the self-hosted web search and fetch MCP server on Railway

A hosted web-search API bills per query and keeps your agent's search traffic on someone else's servers.

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 DonSeTch 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 DonSeTch self hosting

Running DonSeTch yourself means deciding where its MCP endpoint and cache live.

ProviderWhat You Get with RailwayWhat You Get with the Other Provider
DigitalOceanA Dockerfile deploy with a public HTTPS domain, a volume at /data, and health checks set in one place.A Droplet or App Platform service where you manage the OS, Docker, TLS, and volume backups yourself.
AWSThe template without IAM policies, load balancers, or task definitions for this one service.Fine-grained control over networking and storage, with more setup before the first request works.
HetznerA template and a generated bearer token, with no server to patch or firewall.Low-cost bare VPS capacity where you install Docker, configure systemd, and secure the MCP port yourself.

Pick the option whose operations work matches how much infrastructure you want to maintain.

Common Use Cases for hosted DonSeTch

  • Remote research agent: Point an MCP client such as Claude Code or Cursor at your Railway HTTPS domain plus /mcp, so the agent can search the web without a required search API key.
  • Reading documentation and PDFs: Ask the agent to fetch pages as markdown, including PDFs and pages that run JavaScript in process.
  • Site mapping and crawling: Use the crawl tool to walk a documentation site and return a bounded digest the agent can work from.
  • Scanned document extraction: Run OCR on image-only pages when text is not directly extractable.
  • Shared team endpoint: Keep one always-on URL that several AI clients reach, guarded by a bearer token in the Authorization header.

Dependencies for DonSeTch Docker hosted on Railway

This template runs one public service on port 8080 with a volume at /data, health check /health (timeout 120 seconds), and restart policy Always. Keep one replica, because the cache and learned routes live on that volume. The token is generated at deploy time, so no inputs are needed.

Deployment Dependencies for Managed DonSeTch Service

The donsetch service listens on port 8080 with a public domain and mounts a volume at /data for the fetch and search cache and learned per-site routes. The health check is /health with a 120 second timeout, and the restart policy is Always. /health stays public. /mcp requires the bearer token.

Implementation Details for DonSeTch

The image is ghcr.io/onepush-dev/donsetch:5.5.4, the unmodified upstream v5.5.4 linux-x64 release binary (sha256-verified) on debian:trixie-slim, started as donsetch mcp in HTTP mode, with tini as PID 1, running as root so the Railway volume is writable. Baked values are DONSETCH_TRANSPORT=http, DONSETCH_HTTP_HOST=0.0.0.0, DONSETCH_HTTP_PORT=8080, XDG_CACHE_HOME=/data/cache and NO_COLOR=1. This packaging features web_fetch, web_search, web_crawl and OCR. Chrome is not bundled, so do not treat screenshot as a working feature. Requests leave from a datacenter IP, so some sites show more bot walls than from a home connection.

The template generates DONSETCH_HTTP_TOKEN with zero inputs. MCP clients must send it as an Authorization Bearer header to the Railway HTTPS domain plus /mcp. If you clear the token, the MCP endpoint becomes public.

How does DonSeTch compare against other tools

DonSeTch vs a hosted web-search API (Hosted Search API Alternative)

  • Key handling: DonSeTch's default tools need no API keys, while a hosted search API usually requires an account and a key before the first call.
  • Control of traffic: Requests from DonSeTch go to the sites you ask for, and you choose where the server runs.
  • Where the hosted API wins: A hosted search API can be stronger on relevance and freshness, so add your own search key alongside DonSeTch if relevance matters most.

DonSeTch vs running the same binary locally (Local Binary Alternative)

  • Shared access: The Railway service exposes one HTTPS endpoint at your Railway domain plus /mcp, so several agents and machines can reach it.
  • Token protection: Requests to /mcp need DONSETCH_HTTP_TOKEN sent as an Authorization Bearer header, and clearing the token makes the endpoint public.
  • Where local wins: A local binary avoids datacenter IPs, which meet more bot walls than home IPs, and needs no always-on service to manage.

DonSeTch with Docker vs Railway (Docker Alternative)

  • Same image: The Railway template runs ghcr.io/onepush-dev/donsetch:5.5.4, built on the unmodified upstream v5.5.4 release binary, which is sha256-verified.
  • Less setup: Railway supplies the public domain, the /data volume, the /health check and the restart policy for you.
  • Where Docker wins: A plain Docker host gives you full control over networking, host resources and volume location, and you handle updates yourself.

How to use DonSeTch on Railway?

  1. Open the donsetch service in your Railway project and copy the value of DONSETCH_HTTP_TOKEN from the Variables tab. Treat it as a password.
  2. In your MCP client, add a remote server pointing at your Railway HTTPS domain plus /mcp, and send the token as an Authorization Bearer header. For Claude Code, the command looks like this:
claude mcp add --transport http donsetch https://your-domain/mcp --header "Authorization: Bearer your-token"
  1. Check that the service is up by requesting https://your-domain/health without a token. It should return a healthy response, because /health is public.
  2. Ask your agent to search, fetch or crawl a page you care about, and confirm it returns readable content.
  3. Keep the service at one replica, since the /data volume holds the local cache and learned routes. Do not rely on web_screenshot, because Chrome is not bundled in this image.

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

Clone the Repository

Clone the community packaging repository on your VPS to read the Dockerfile and railway.toml. It is not affiliated with or endorsed by DonSeTch.

git clone https://github.com/onepush-dev/donsetch.git
cd donsetch

Install Dependencies

Install Docker, or use a host with curl and tini to run the release binary directly.

docker --version

Configure Environment Variables

Set a long bearer token for MCP clients and a persistent cache path. Use your own values and never reuse example credentials.

export DONSETCH_HTTP_TOKEN=your-long-random-token

Start the DonSeTch Application

Run the container with the cache volume mounted and port 8080 published. Keep a single instance, since local state should not be shared across replicas.

docker run -d -p 8080:8080 \
  -e DONSETCH_HTTP_TOKEN="$DONSETCH_HTTP_TOKEN" \
  -v /var/lib/donsetch:/data \
  ghcr.io/onepush-dev/donsetch:5.5.4

Check http://your-domain:8080/health, then point your MCP client at /mcp with Authorization: Bearer and your token.

Pricing and License of DonSeTch (DonSeTch pricing)

DonSeTch is open-source software licensed under AGPL-3.0, and you can self-host it at no licence cost.

DonSeTch hosted vs self hosted comparison (Pricing, features, costs, and more)

This template packages the AGPL-3.0 software.

Monthly cost of self hosting DonSeTch on Railway

Railway costs are usage-based and depend on the RAM, CPU, and volume size of the donsetch service, plus any other services in the project.

System Requirements for Hosting DonSeTch on a VPS

A VPS needs enough memory and disk for the fetch and search cache under /data, plus a network path to the sites you query.

Frequently Asked Questions (FAQs)

How do I connect a client to my DonSeTch deployment?

Point your MCP client at your Railway HTTPS domain plus /mcp, and send DONSETCH_HTTP_TOKEN as an Authorization Bearer header.

Is /health protected by the token?

No. /health is public so Railway's health check can reach it, and it does not need the bearer token. Only the /mcp endpoint requires DONSETCH_HTTP_TOKEN.

What happens if I clear the token?

If you clear DONSETCH_HTTP_TOKEN, the MCP endpoint becomes public and anyone who knows the URL can use it. Keep the token set and treat it as a secret.

Does screenshot work on this template?

No. web_screenshot needs Chrome, which is not bundled in this packaging, so do not rely on it. Use web_fetch, web_search, web_crawl and OCR instead.

What should I back up?

Back up the /data volume, which holds the fetch and search cache and the learned per-site routes, and keep DONSETCH_HTTP_TOKEN secret. A fresh volume starts with an empty cache.

Do I need a search API key?

No. web_search, web_fetch, web_crawl and OCR run without a required provider key. Optional providers and proxies can be added later from the upstream environment variables if you need them.


Template Content

More templates in this category

View Template
Chat Chat
Chat Chat, your own unified chat and search to AI platform.

okisdev
117
View Template
Weaviate
Vector database with hybrid search and an API key-protected API

GitHub Locker
1
View Template
Möbius Personal AI OS
Self-hosted AI agent that builds and runs apps for you, with memory.

bento
1