insforge--insforge/deploy/docker-deploy.md

Deploy InsForge with Docker

Prerequisites

• Docker and Docker Compose installed on your machine

Setup InsForge

Step 1: Download the Docker Compose file

wget https://raw.githubusercontent.com/insforge/insforge/main/deploy/docker-compose/docker-compose.yml
wget https://raw.githubusercontent.com/insforge/insforge/main/deploy/docker-compose/.env.example
mv .env.example .env

Step 2: Start InsForge

docker compose up -d

Step 3: Access InsForge

Open your browser and navigate to http://localhost:7130, you can see the InsForge dashboard as below:

Running Multiple Instances

You can run multiple InsForge projects on the same host by using different ports and project names.

Step 1: Create a separate env file for each project

cp .env.example .env.project1
cp .env.example .env.project2

Step 2: Edit each env file with unique ports

.env.project1 (default ports):

POSTGRES_PORT=5432
POSTGREST_PORT=5430
APP_PORT=7130
AUTH_PORT=7131
DENO_PORT=7133

.env.project2 (different ports):

POSTGRES_PORT=5442
POSTGREST_PORT=5440
APP_PORT=7230
AUTH_PORT=7231
DENO_PORT=7233

Make sure each project has its own JWT_SECRET and ROOT_ADMIN_PASSWORD.

Step 3: Start each project with a unique name

docker compose --env-file .env.project1 -p project1 up -d
docker compose --env-file .env.project2 -p project2 up -d

The -p flag gives each project isolated containers, volumes, and networks. The --env-file flag assigns unique ports so they don't conflict.

Managing multiple instances

# Check status
docker compose --env-file .env.project1 -p project1 ps

# View logs
docker compose --env-file .env.project1 -p project1 logs -f

# Stop an instance
docker compose --env-file .env.project1 -p project1 down

# Stop and remove all data
docker compose --env-file .env.project1 -p project1 down -v

Each project has its own database, storage, and configuration. They are completely independent.

---

Start using InsForge

1. Connect InsForge MCP

Open InsForge Dashboard, Follow the steps to connect InsForge MCP Server:

2. Verify installation

To verify the connection, send the following prompt to your agent:

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to learn about InsForge instructions.

3. Start building your project

Build your next todo app, Instagram clone, or online platform in seconds!

Sample Project Prompt:

Build an app similar to Reddit with community-based discussion threads using InsForge as the backend platform that has these features:

- Has a "Communities" list where users can browse or create communities
- Each community has its own posts feed
- Users can create posts with a title and body (text or image upload to InsForge storage)
- Users can comment on posts and reply to other comments
- Allows upvoting and downvoting for both posts and comments
- Shows vote counts and comment counts for each post