Skip to main content

Local backend

Use --backend-only to start a local backend. Each backend runs behind an ingress proxy on its own port.

Start a backend​

faheem-code --backend-only

This starts the backend on 127.0.0.1:8000. No frontend is served.

Running multiple backends​

You can run several backends at the same time on different ports — for example, one per project or toolchain:

faheem-code --backend-only --port 8001
faheem-code --backend-only --port 8002
faheem-code --backend-only --port 8003

Each instance gets its own backend and ingress proxy.

Connect the frontend​

Start the frontend separately:

faheem-code --frontend-only

Then add your backends through Manage Backends:

  1. Click the backend switcher → Manage Backends → Add Backend.
  2. Fill in the Host / Base URL (e.g. http://localhost:8001) and API Key.
  3. Repeat for each backend you started.

Switch between them from the backend selector depending on what you're working on.