teable

环境要求

• Node.js 运行环境（pnpm 依赖它运行）
• pnpm 包管理器（README 使用 pnpm install / pnpm dev）
• 自托管完整版需要一台可访问的服务器或集群，并准备域名与 DNS（交给 teable-deployment）
• 底层数据库为 PostgreSQL

安装与启动步骤

1. 1选择运行方式

   README 给出三种：Teable Cloud 云端、功能完整自托管（teable-deployment）、精简自托管（Docker 指南）。按是否需要 AI 与 App Builder 选择。

2. 2云端直接体验

   不想自己部署时，直接使用官方托管版本注册即可体验全部表格、协作与 AI 功能。

3. 3获取项目源码

   把仓库克隆到本地，作为本地开发或自行构建的基础。

   git clone https://github.com/teableio/teable.git

   复制

4. 4安装依赖

   在项目根目录执行，按 lockfile 安装全部 workspace 依赖，耗时较长请耐心等待。

   pnpm install

   复制

5. 5启动开发服务

   只需启动后端，它会自动拉起前端 Next 服务，改动文件会自动热重载。

   cd apps/nestjs-backend
   pnpm dev

   复制

6. 6完整自托管部署

   需要 AI 聊天/智能体与 App Builder 时，按 teable-deployment 仓库部署；只读 Docker 指南为精简版，不含 AI 功能。

如何确认成功

执行 pnpm dev 后后端启动并自动带起前端 Next 服务，浏览器打开对应地址即可看到 Teable 表格界面。

常见问题

注意事项

• 完整自托管（含 AI 与 App Builder）请使用 teableio/teable-deployment 仓库，而非直接手改代码部署。
• 精简自托管不含 AI 功能与 App Builder，只有表格、协作、API 与自动化。
• 本地开发只需启动后端 apps/nestjs-backend，前端会由它自动拉起。
• README 未给出默认端口、环境变量等细节，实际配置请查阅官方部署文档 help.teable.ai。