Self-Hosting

The fastest way to get Jiro running on your own infrastructure. Requires Python 3.10+ and Redis.

Step 1: Install - pip install jirosearch

Step 2: Start the server - jiro serve

Step 3: Verify - curl http://localhost:8000/health

The server starts on port 8000 by default. All 9 search engines and 12 social platforms are available immediately. No API key is required for self-hosted instances unless you enable authentication.

Run Jiro in a Docker container for isolated and reproducible deployments:

Use docker-compose for a complete stack with Redis included:

Run Jiro as a systemd service for automatic startup and process management:

Jiro uses a YAML configuration file at ~/.jiro/config.yaml. All settings can also be overridden with environment variables prefixed with JIRO_ (double underscore __ for nested keys). Secrets can be interpolated from the environment using ${VAR} syntax.

All configuration options can be set via environment variables. Use JIRO_ prefix with double underscores __ for nested keys. Secrets can use ${VAR} interpolation in YAML.