Documentation

Self-hosting & Deployment

Deploy to Fly, Render, or any Docker host. Hobby-tier friendly (512MB–1GB).

Environment

PORT Default 7431 (api), 7432 (web)
REDIS_URL Required for /v1/crawl, /v1/batch, /v1/monitor
SEARXNG_URL Default http://searxng:8080 (compose)
API_KEYS Comma-separated keys to enable auth
RATE_LIMIT_RPM Requests per minute (optional)

Fly.io

fly launch --dockerfile packages/api/Dockerfile
fly secrets set REDIS_URL=redis://...
fly deploy

Docker Hub / GHCR

docker pull michaelobele/tomoshibi:latest
docker pull ghcr.io/michael-obele/tomoshibi:latest

Support the project

How to help

  • ✓ Star on GitHub — https://github.com/Michael-Obele/tomoshibi
  • ✓ Sponsor — https://github.com/sponsors/Michael-Obele (see FUNDING.yml)
  • ✓ Share your self-hosting setup in Discussions