ScriptsApr 10, 2026·3 min read

Teable — No-Code Postgres Spreadsheet Database

Teable is an open-source Airtable alternative built on PostgreSQL. Spreadsheet UI with real-time collaboration, API access, and no-code app building capabilities.

TL;DR
Teable provides a spreadsheet UI on top of PostgreSQL with real-time collaboration and API access.
§01

What it is

Teable is an open-source alternative to Airtable built on PostgreSQL. It combines a familiar spreadsheet interface with the power of a real relational database, offering real-time collaboration, REST API access, and no-code application building capabilities.

It targets teams who outgrow spreadsheets but find traditional database tools too complex. Product managers, operations teams, and small development shops use Teable to manage structured data with the ease of a spreadsheet and the reliability of Postgres.

§02

How it saves time or tokens

Teable eliminates the gap between spreadsheets and databases. Teams no longer need to export CSV files, write migration scripts, or maintain separate data entry interfaces. The built-in API means AI agents and automation tools can read and write data directly, saving the token overhead of converting between formats.

§03

How to use

  1. Deploy Teable using Docker Compose or the cloud-hosted version.
  2. Create a table with columns (fields) using the spreadsheet interface, choosing from field types like text, number, date, attachment, and linked records.
  3. Use the REST API or built-in views (grid, kanban, form, gallery) to interact with your data programmatically or visually.
§04

Example

# Deploy Teable with Docker Compose
git clone https://github.com/teableio/teable.git
cd teable
docker compose up -d
# Access at http://localhost:3000
# Query data via the REST API
curl -H 'Authorization: Bearer YOUR_API_TOKEN' \
  'https://your-teable-instance/api/table/tbl_xxx/record?filter={"field_name":{"eq":"active"}}'
§05

Related on TokRepo

§06

Common pitfalls

  • Treating Teable as a simple spreadsheet and ignoring field types, which leads to data quality issues when using the API.
  • Not setting up proper access controls when exposing the API to external tools or AI agents.
  • Overlooking the PostgreSQL connection string for direct database access when Teable's API does not cover a specific query pattern.

Frequently Asked Questions

How is Teable different from Airtable?+

Teable is open source and self-hosted, so your data stays on your infrastructure. It uses a real PostgreSQL database under the hood, meaning you can connect with standard SQL tools. Airtable is a proprietary SaaS product with usage-based pricing.

Can I query Teable data with SQL?+

Yes. Since Teable stores data in PostgreSQL, you can connect any SQL client or BI tool directly to the underlying database. This gives you full SQL power alongside the spreadsheet interface.

Does Teable support real-time collaboration?+

Yes. Multiple users can edit the same table simultaneously with changes reflected in real time, similar to Google Sheets or Airtable. Conflict resolution is handled automatically.

Can I self-host Teable?+

Yes. Teable provides Docker Compose files for self-hosting. You need PostgreSQL, Redis, and the Teable application containers. The setup is straightforward for teams familiar with Docker.

Does Teable have an API for automation?+

Yes. Teable exposes a REST API for CRUD operations on tables and records. You can use it with automation tools, AI agents, or custom scripts to read, create, update, and delete records programmatically.

Citations (3)
🙏

Source & Thanks

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets