Skip to main content

Development Mode in Agenta

This guide explains how to run Agenta locally in development mode while you work on the codebase.

Start Agenta In Development Mode​

Development mode gives you hot reload, which makes local development much faster.

1. Clone The Repository​

git clone https://github.com/Agenta-AI/agenta.git
cd agenta

2. Configure The Environment​

Copy the example env file:

cp hosting/docker-compose/oss/env.oss.dev.example hosting/docker-compose/oss/.env.oss.dev

If you are running on a remote server, open .env.oss.dev and set AGENTA_WEB_URL to your server's IP address (for example http://192.168.1.100). If you are running locally, the defaults are fine.

3. Launch The Server​

./hosting/docker-compose/run.sh --license oss --dev

If you want to run the Next.js web app outside the container, use:

./hosting/docker-compose/run.sh --license oss --dev --no-web

4. Verify The Installation​

Open your browser and go to http://localhost. If you see the Agenta web interface, the setup is working.

Debugging The Backend​

The easiest way to debug the backend is to inspect the Docker logs.

  1. Open Docker Desktop.
  2. Select the backend container.
  3. Click on the Logs button.

If you use Visual Studio Code, you can also open the Docker tab, select the backend container, and view its logs there.