English
Get started
← All templates

Deploy GitNexus on Pethost in one click

Index a code repository into a knowledge graph and explore it, or let an agent query it over MCP

What happens

  1. You sign in to Pethost or make an account, with a passkey, GitHub or Google.
  2. No machine yet? You pick a plan, and we prepare one for you. The link waits in your browser until it is ready.
  3. New project opens at the app, and you click Create project.
  4. In a minute or two the app is live at its own address with HTTPS. Its secrets are made for it at random, and its data is in the nightly backup.
  5. It is a project like any other: its compose.yaml, its .env, its logs and a terminal are in the panel, and your agent can change it, roll it back or restore it.

First steps

The site asks for an access token: TOKEN in the project’s .env. The browser forgets it with the tab, and an agent sends it to the address’s /api/mcp. Whoever has it reads every indexed repository. Its license, PolyForm Noncommercial, allows noncommercial use only.

What it runs

The template is this compose.yaml and the variables it writes into the project’s .env. Pethost runs the file as it is written.

services:
  # The UI, and the one way in: it forwards /api to the server only with the token.
  web:
    image: ghcr.io/abhigyanpatwari/gitnexus-web:1.6.12
    restart: unless-stopped
    environment:
      GITNEXUS_BACKEND_URL: ${URL}
      GITNEXUS_UPSTREAM_URL: http://server:4747
      GITNEXUS_SERVE_AUTH_TOKEN: ${TOKEN}
      GITNEXUS_PROXY_TRUST_XFF: 1
    depends_on:
      - server

  # Indexes repositories into a knowledge graph; it has no address of its own.
  server:
    image: ghcr.io/abhigyanpatwari/gitnexus:1.6.12
    restart: unless-stopped
    environment:
      GITNEXUS_TRUST_PROXY: 1
    # The registry, the indexes and the cloned repositories.
    volumes:
      - data:/data/gitnexus

volumes:
  data: