Розгортання за допомогою Docker

Docker Compose рекомендовано для невеликих команд і ознайомлення (< 50 користувачів). Не впевнені, що цей варіант вам підходить? Почніть зі сторінки Розгортання. Потрібні функції ШІ або App Builder? Для нового розгортання скористайтеся повнофункціональною платформою; якщо це автономне розгортання вже працює, дотримуйтеся посібника з міграції — ваші дані залишаться на місці.

Розгортання за допомогою Docker Compose

Рекомендований масштаб: 0–50 користувачів

Переваги	Недоліки
Просте розгортання	Розгортання на одному сервері, складне масштабування
Повний контроль
Гнучке налаштування

Вимоги до сервера Переконайтеся, що ваш сервер відповідає цим базовим вимогам:

Операційна система: рекомендований дистрибутив Linux, наприклад Ubuntu 20.04 LTS
Пам’ять: щонайменше 4 ГБ оперативної пам’яті
Процесор: щонайменше 2 ядра
Місце на диску: щонайменше 40 ГБ вільного простору
Мережа: стабільне інтернет-з’єднання з доступом до необхідних портів

Передумови

Перш ніж почати, переконайтеся, що:

Ви розумієте основи Docker і принципи контейнеризації
На вашому комп’ютері встановлено Docker і Docker Compose. Інструкції зі встановлення наведено в офіційній документації Docker.

Встановлення Docker

# Завантажте найновішу версію Docker
curl -fsSL https://get.docker.com | bash -s docker

# Перевірте встановлення
docker --version
docker-compose --version

Встановлення застосунку

Створення файлу docker-compose.yaml

Підключіться до сервера, створіть папку teable та перейдіть до неї:

mkdir teable

cd teable

Створіть файли docker-compose.yaml і .env, а потім вставте такий вміст:

vim docker-compose.yaml

Мінімальне розгортання:

docker-compose.yaml

services:
  teable:
    image: ghcr.io/teableio/teable:latest
    restart: always
    ports:
      - '3000:3000'
    volumes:
      - teable-data:/app/.assets:rw
    env_file:
      - .env
    environment:
      - NEXT_ENV_IMAGES_ALL_REMOTE=true
    networks:
      - teable
    depends_on:
      teable-db:
        condition: service_healthy
      teable-cache:
        condition: service_healthy
    healthcheck:
      test: ['CMD', 'curl', '-f', 'http://localhost:3000/health']
      start_period: 5s
      interval: 5s
      timeout: 3s
      retries: 3

  teable-db:
    image: postgres:15.4
    restart: always
    ports:
      - '42345:5432'
    volumes:
      - teable-db:/var/lib/postgresql/data:rw
    environment:
      - POSTGRES_DB=${POSTGRES_DB}
      - POSTGRES_USER=${POSTGRES_USER}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
    networks:
      - teable
    healthcheck:
      test: ['CMD-SHELL', "sh -c 'pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}'"]
      interval: 10s
      timeout: 3s
      retries: 3

  teable-cache:
    image: redis:7.2.4
    restart: always
    expose:
      - '6379'
    volumes:
      - teable-cache:/data:rw
    networks:
      - teable
    command: redis-server --appendonly yes --requirepass ${REDIS_PASSWORD}
    healthcheck:
      test: ['CMD', 'redis-cli', '--raw', 'incr', 'ping']
      interval: 10s
      timeout: 3s
      retries: 3

networks:
  teable:
    name: teable-network

volumes:
  teable-db: {}
  teable-data: {}
  teable-cache: {}

.env

# Замініть наведений нижче стандартний пароль на надійний пароль (ASCII) завдовжки щонайменше 8 символів.
POSTGRES_PASSWORD=replace_this_password
REDIS_PASSWORD=replace_this_password
SECRET_KEY=replace_this_secret_key

# Замініть наведену нижче адресу на загальнодоступну
PUBLIC_ORIGIN=http://127.0.0.1:3000

# ---------------------

# Postgres
POSTGRES_HOST=teable-db
POSTGRES_PORT=5432
POSTGRES_DB=teable
POSTGRES_USER=teable

# Redis
REDIS_HOST=teable-cache
REDIS_PORT=6379
REDIS_DB=0

# Застосунок
PRISMA_DATABASE_URL=postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@${POSTGRES_HOST}:${POSTGRES_PORT}/${POSTGRES_DB}
BACKEND_CACHE_PROVIDER=redis
BACKEND_CACHE_REDIS_URI=redis://default:${REDIS_PASSWORD}@${REDIS_HOST}:${REDIS_PORT}/${REDIS_DB}

Додавання служби зберігання (необов’язково)

Для виробничих розгортань використовуйте об’єктне сховище, сумісне із S3 (наприклад, S3, MinIO, OSS/OBS/COS із сумісними із S3 кінцевими точками або інший сумісний сервіс), щоб підвищити надійність і спростити масштабування.

Додавання MinIO до docker-compose
Підключення до зовнішнього MinIO
Підключення до AWS S3

MinIO надає додатковий інтерфейс керування сховищем (порт 9001), а також потужніший і стабільніший файловий сервіс.

docker-compose.yaml

services:
  # ...попередній вміст
  teable-storage:
    image: minio/minio:RELEASE.2024-02-17T01-15-57Z
    ports:
      - "9000:9000"
      - "9001:9001"
    environment:
      - MINIO_ACCESS_KEY=${MINIO_ACCESS_KEY}
      - MINIO_SECRET_KEY=${MINIO_SECRET_KEY}
    volumes:
      - teable-storage:/data:rw
    networks:
      - teable
    command: server /data --console-address ":9001"
  createbuckets:
    image: minio/mc
    networks:
      - teable
    entrypoint: >
      /bin/sh -c "
      /usr/bin/mc alias set teable-storage http://teable-storage:9000 ${MINIO_ACCESS_KEY} ${MINIO_SECRET_KEY};
      /usr/bin/mc mb teable-storage/public;
      /usr/bin/mc anonymous set public teable-storage/public;
      /usr/bin/mc mb teable-storage/private;
      exit 0;
      "
    depends_on:
      teable-storage:
        condition: service_started

networks:
  teable:
    name: teable-network

volumes:
  teable-db: {}
  teable-cache: {}
  # Додайте новий том
  teable-storage: {}

.env

# Замініть наведені нижче стандартні паролі на надійні паролі (ASCII) завдовжки щонайменше 8 символів.
POSTGRES_PASSWORD=replace_this_password
REDIS_PASSWORD=replace_this_password
SECRET_KEY=replace_this_secret_key

# Якщо ви ввімкнули HTTPS, задайте для PROTOCOL значення https.
PROTOCOL=http
# Укажіть у PUBLIC_HOST IP-адресу або доменне ім’я вашого розгортання. Не можна використовувати localhost або 127.0.0.1.
PUBLIC_HOST=192.168.x.x
# Змініть останній порт відповідно до порту доступу або вилучіть :port, якщо використовуєте стандартні порти (80/443).
PUBLIC_ORIGIN=${PROTOCOL}://${PUBLIC_HOST}:3000

# ---------------------

# Postgres
POSTGRES_HOST=teable-db
POSTGRES_PORT=5432
POSTGRES_DB=teable
POSTGRES_USER=teable

# Redis
REDIS_HOST=teable-cache
REDIS_PORT=6379
REDIS_DB=0

# Minio
MINIO_ACCESS_KEY=teable_minio_access
MINIO_SECRET_KEY=${SECRET_KEY}

# Застосунок
PRISMA_DATABASE_URL=postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@${POSTGRES_HOST}:${POSTGRES_PORT}/${POSTGRES_DB}
BACKEND_CACHE_PROVIDER=redis
BACKEND_CACHE_REDIS_URI=redis://default:${REDIS_PASSWORD}@${REDIS_HOST}:${REDIS_PORT}/${REDIS_DB}
BACKEND_STORAGE_PROVIDER=minio
BACKEND_STORAGE_PUBLIC_BUCKET=public
BACKEND_STORAGE_PRIVATE_BUCKET=private
BACKEND_STORAGE_MINIO_USE_SSL=false # Якщо ви ввімкнули HTTPS, змініть це значення на true
BACKEND_STORAGE_MINIO_ENDPOINT=${PUBLIC_HOST}
BACKEND_STORAGE_MINIO_PORT=9000
BACKEND_STORAGE_MINIO_ACCESS_KEY=${MINIO_ACCESS_KEY}
BACKEND_STORAGE_MINIO_SECRET_KEY=${MINIO_SECRET_KEY}
STORAGE_PREFIX=${PROTOCOL}://${PUBLIC_HOST}:${BACKEND_STORAGE_MINIO_PORT}

Перш ніж почати, створіть у MinIO два бакети. У загальнодоступному бакеті зберігатимуться зображення профілів і заголовки форм, а в приватному — вміст вкладень.

.env

# ...попередній вміст
# Використовуйте постачальника MinIO
BACKEND_STORAGE_PROVIDER=minio
# Назва загальнодоступного бакета
BACKEND_STORAGE_PUBLIC_BUCKET=public
# Назва приватного бакета
BACKEND_STORAGE_PRIVATE_BUCKET=private
# IP-адреса або доменне ім’я кінцевої точки сервісу MinIO
BACKEND_STORAGE_MINIO_ENDPOINT=minio.example.com
# Порт MinIO
BACKEND_STORAGE_MINIO_PORT=443
# Чи ввімкнено HTTPS
BACKEND_STORAGE_MINIO_USE_SSL=true
# Ключ доступу MinIO
BACKEND_STORAGE_MINIO_ACCESS_KEY=_minio_access_key_
# Секретний ключ MinIO
BACKEND_STORAGE_MINIO_SECRET_KEY=_minio_secret_key_
# Повна адреса доступу
STORAGE_PREFIX=https://minio.example.com

# ---Налаштування внутрішньої мережі (необов’язково)---
# IP-адреса або доменне ім’я внутрішньої кінцевої точки сервісу MinIO (HTTPS не підтримується)
BACKEND_STORAGE_MINIO_INTERNAL_ENDPOINT=teable-storage.internal
# Внутрішній порт MinIO
BACKEND_STORAGE_MINIO_INTERNAL_PORT=9000
# ---налаштування регіону (необов’язково)---
# Назва регіону
BACKEND_STORAGE_MINIO_REGION=us-east-1

Примітка: необхідно налаштувати два бакети (загальнодоступний і приватний). Загальнодоступний бакет повинен мати режим public-read і дозволяти CORS для будь-якого джерела, інакше доступ із браузера може не працювати.

Перш ніж почати, створіть в AWS S3 два бакети. Один загальнодоступний бакет — для зберігання аватарів і заголовків форм, а один приватний — для зберігання вмісту вкладень.

.env

# ...попередній вміст
# Використовуйте стандартного постачальника S3
BACKEND_STORAGE_PROVIDER=s3
# Назва регіону
BACKEND_STORAGE_S3_REGION=us-west-2
# Кінцева точка, обов’язково з протоколом (зазвичай https)
BACKEND_STORAGE_S3_ENDPOINT=https://s3.us-west-2.amazonaws.com
# Ключ доступу
BACKEND_STORAGE_S3_ACCESS_KEY=access_key
# Секретний ключ
BACKEND_STORAGE_S3_SECRET_KEY=secret_key
# Загальнодоступний бакет
BACKEND_STORAGE_PUBLIC_BUCKET=your-public-bucket
# Приватний бакет
BACKEND_STORAGE_PRIVATE_BUCKET=your-private-bucket
# Повна адреса доступу — адреса доступу до вашого загальнодоступного бакета
STORAGE_PREFIX=https://your-public-bucket.s3.us-west-2.amazonaws.com

Цей процес застосовний до більшості хмарних постачальників, а не лише до AWS S3.

Запуск застосунку

Виконайте наведені нижче команди в поточному каталозі, щоб запустити застосунок. Після запуску він буде доступний за адресою 127.0.0.1:3000

Для масштабних операцій копіювання даних потрібне середовище HTTPS, інакше асинхронний доступ до буфера обміну буде недоступний

docker-compose pull

docker-compose up -d

Використання керованих баз даних (необов’язково)

Якщо ви віддаєте перевагу керованим базам даних, процес розгортання можна додатково спростити:

Видаліть services.teable-db
Видаліть volumes.teable-db
Оновіть .env, указавши конфігурацію керованої бази даних

Заповніть параметри бази даних відповідно до параметрів підключення до вашої керованої бази даних:

.env

POSTGRES_HOST=your-database.com
POSTGRES_PORT=5432
POSTGRES_DB=teable
POSTGRES_USER=teable

Зверніть увагу: 127.0.0.1 — це внутрішня мережа контейнера. Щоб підключитися до локально розгорнутої бази даних, використовуйте як адресу хоста host.docker.internal замість 127.0.0.1, інакше підключення не вдасться

Аналогічні дії для зовнішнього керованого Redis:

Видаліть service.teable-cache
Видаліть service.teable.depends_on.teable-cache
Видаліть volumes.teable-cache
Оновіть .env, указавши конфігурацію керованого Redis

Подальші кроки

Налаштуйте поштовий сервіс

Підтримка та зворотний зв’язок

Якщо під час розгортання виникнуть проблеми, зверніться до нашої служби підтримки за адресою support@teable.ai або створіть повідомлення про проблему.

Ліцензія

Teable містить функції Community з відкритим вихідним кодом за ліцензією AGPL-3.0. Щоб розблокувати платні функції в самостійно розміщених розгортаннях, оформте підписку на нашій сторінці тарифів.

Образ ghcr.io/teableio/teable:latest містить повний набір функцій. Для активації платних функцій потрібна дійсна ліцензія за підпискою.Якщо вам потрібен лише набір функцій Community з відкритим вихідним кодом, виберіть образ ghcr.io/teableio/teable-community:latest.

Поширені проблеми

Як увійти після першого розгортання?

Після запуску екземпляра відкрийте його URL-адресу та створіть там обліковий запис. У Teable немає попередньо налаштованого облікового запису адміністратора, а ваш самостійно розміщений екземпляр не використовує обліковий запис хмарного сервісу teable.ai.Перший користувач, який зареєструється в екземплярі, стане його адміністратором.

Чому після встановлення не вдається імпортувати CSV/xlsx або завантажувати зображення

Проблеми з імпортом файлів зазвичай виникають через неправильне налаштування змінної середовища PUBLIC_ORIGIN. Для PUBLIC_ORIGIN потрібно вказати адресу, за якою зараз доступний екземпляр:

# Для локальної розробки
PUBLIC_ORIGIN=http://127.0.0.1:3000

# Для доступу з локальної мережі
PUBLIC_ORIGIN=http://192.168.1.100:3000

# Для доступу за доменним ім’ям
PUBLIC_ORIGIN=https://teable.example.com

Важливо: не додавайте косу риску (”/”) у кінці URL-адреси.

Після зміни цього налаштування необхідно перезапустити екземпляр Teable, щоб зміни набули чинності.

Як увімкнути HTTPS

Щоб увімкнути HTTPS, виконайте такі дії:

Отримайте дійсний сертифікат SSL
Задайте PROTOCOL=https (або PUBLIC_ORIGIN=https://teable.example.com, залежно від конфігурації)
Якщо використовуєте MinIO, задайте BACKEND_STORAGE_MINIO_USE_SSL=true

Для завершення SSL-з’єднання рекомендуємо використовувати зворотний проксі-сервер (наприклад, Nginx або Traefik).

Якщо ви не впевнені, як налаштувати Nginx (HTTPS/сертифікати, WebSocket, мережі Docker, Nginx Proxy Manager тощо), див. Nginx (зворотний проксі-сервер).

Як створювати резервні копії даних?

Для розгортань Docker Compose доступно кілька варіантів резервного копіювання:Варіант 1. Повна резервна копія віртуальної машини (рекомендовано для простоти)

Регулярно створюйте резервну копію всієї віртуальної машини, на якій розміщено Teable
Забезпечує повне відновлення системи

Варіант 2. Резервне копіювання томів Docker

Створюйте резервні копії всіх томів Docker, визначених у файлі docker-compose.yaml
Переглянути томи: docker volume ls

Створити резервну копію тому:

docker run --rm -v <volume_name>:/data -v $(pwd):/backup alpine tar czf /backup/<volume_name>.tar.gz /data

Варіант 3. Резервне копіювання окремих компонентів (рекомендовано для детального контролю)

База даних PostgreSQL: містить усі дані таблиць
docker exec teable-db pg_dump -U teable teable > backup.sql
База даних Redis: містить дані черги автоматизацій
docker exec teable-cache redis-cli --rdb /data/dump.rdb
Каталог даних: створіть резервну копію тому teable-data (містить усі файли вкладень)
docker run --rm -v teable-data:/data -v $(pwd):/backup alpine tar czf /backup/teable-data.tar.gz /data

Для виробничих середовищ рекомендуємо налаштувати автоматичне щоденне резервне копіювання з політиками зберігання.

AI

Space

Automation

Base

Authority Matrix

SSO

Comparison

Розгортання за допомогою Docker