render.yaml

# Render Blueprint for the OpenJarvis FastAPI server.
# Deploys src/openjarvis/server/app.py via deploy/docker/Dockerfile.
# Apply at: https://dashboard.render.com/blueprint/new?repo=https://github.com/open-jarvis/OpenJarvis
services:
  - type: web
    name: openjarvis-server
    runtime: docker
    plan: free
    region: oregon
    dockerfilePath: ./deploy/docker/Dockerfile
    dockerContext: .
    # Override the Dockerfile CMD while preserving its `jarvis` entrypoint.
    # Render's default web-service port is 10000. Pin PORT and the CLI argument
    # to that same value because Docker commands do not interpolate `$PORT`.
    # Pin a cloud model as well as the engine. The repository's default model
    # is local-only, so omitting this would make `jarvis serve` reject the
    # otherwise healthy cloud engine during startup.
    dockerCommand: serve --host 0.0.0.0 --port 10000 --engine cloud --model gpt-4o-mini
    healthCheckPath: /health
    autoDeploy: true
    envVars:
      # Force the cloud engine path. The free Render plan has no GPU and the
      # bundled local backends (Ollama/vLLM) cannot run here. The command above
      # selects the OpenAI-backed cloud engine and a model it can serve.

      # Keep Render's expected public port aligned with the fixed Docker
      # command above. Change both values together when customizing the port.
      - key: PORT
        value: "10000"

      # Auth for the OpenJarvis API itself. Required because the server refuses
      # to bind to a non-loopback host without an API key (check_bind_safety).
      - key: OPENJARVIS_API_KEY
        generateValue: true

      # Required at initial Blueprint creation. Render's `sync: false` fields
      # are operator-supplied secrets; using one provider here keeps the
      # one-click contract deterministic instead of incorrectly requiring a
      # key for every supported cloud provider.
      - key: OPENAI_API_KEY
        sync: false

      # The free service filesystem is ephemeral. OpenJarvis state under this
      # directory is lost on every restart, spin-down, or deploy. See
      # docs/deployment/render.md before storing credentials or durable state.
      - key: OPENJARVIS_HOME
        value: /home/openjarvis/.openjarvis