InsForge

环境要求

• 已安装 Docker，并带 Compose v2
• 可写入用户主目录（如 ~/insforge）的权限
• 从源码构建时需要 Git
• 浏览器访问需能访问 .env 中配置的 API 地址

安装与启动步骤

1. 1拉取部署文件

   执行官方脚本，把部署所需文件下载到 ~/insforge，并自动生成 JWT_SECRET、ENCRYPTION_KEY、POSTGRES_PASSWORD、ROOT_ADMIN_PASSWORD 及两个访问密钥（.env 权限 600）。

   curl -fsSL https://raw.githubusercontent.com/InsForge/InsForge/main/deploy/setup.sh | sh -s ~/insforge

   复制

2. 2编辑 .env

   进入部署目录编辑 .env，重点修改 API_BASE_URL 与 VITE_API_BASE_URL，即浏览器将访问的地址。重复执行 setup.sh 只会刷新文件并保留你已设置的值。

   cd ~/insforge && $EDITOR .env

   复制

3. 3启动服务

   在部署目录直接执行 docker compose up -d。.env 中已设置 COMPOSE_FILE，因此无需再带 -f 参数。

   cd ~/insforge && docker compose up -d

   复制

4. 4验证安装

   向你的编码智能体发送官方给出的提示词，让它调用 InsForge MCP 的 fetch-docs 工具了解 InsForge 使用说明，以确认后端连通。

5. 5多项目隔离

   每个项目用独立目录各跑一次 setup.sh，并在各自 .env 里设置不同的 COMPOSE_PROJECT_NAME 和端口；同名会共享容器，默认端口则会与 ~/insforge 实例冲突。

   curl -fsSL https://raw.githubusercontent.com/InsForge/InsForge/main/deploy/setup.sh | sh -s ~/project1
   curl -fsSL https://raw.githubusercontent.com/InsForge/InsForge/main/deploy/setup.sh | sh -s ~/project2
   cd ~/project1 && docker compose up -d
   cd ~/project2 && docker compose up -d

   复制

6. 6源码构建（可选）

   需要改动 InsForge 本身时使用。docker-compose.prod.yml 不会自动生成密钥，启动前必须自己在 .env 中设置 JWT_SECRET、ENCRYPTION_KEY、POSTGRES_PASSWORD、ROOT_

   git clone https://github.com/InsForge/InsForge.git
   cd InsForge
   cp .env.example .env
   $EDITOR .env
   docker compose -f docker-compose.prod.yml up

   复制

关键配置

如何确认成功

向智能体发送提示词，让它调用 InsForge MCP 的 fetch-docs 工具获取说明；也可在部署目录执行 docker compose ps 查看容器状态。

常见问题

注意事项

• setup.sh 只在目标目录生成 .env（权限 600），不会启动任何服务；启动由 docker compose up -d 完成。
• 多项目部署时默认端口会与 ~/insforge 实例冲突，需自行调整 POSTGRES_PORT、POSTGREST_PORT、APP_PORT、AUTH_PORT、DENO_PORT 等端口。
• 源码构建路径显式传 -f 会覆盖 COMPOSE_FILE；如需叠加配置，应继续追加 -f 参数而不是改该变量。
• docker-compose.prod.yml 对未设置的变量会回退到已发布的默认值，任何对外暴露的实例都应自行设置好密钥。