Skip to content

Document required PostgreSQL role privileges for TTS database migrations#1481

Merged
vlasebian merged 3 commits into
masterfrom
copilot/add-postgres-permissions-docs
Jun 12, 2026
Merged

Document required PostgreSQL role privileges for TTS database migrations#1481
vlasebian merged 3 commits into
masterfrom
copilot/add-postgres-permissions-docs

Conversation

Copilot AI commented Apr 23, 2026

Copy link
Copy Markdown
Contributor

Migration docs described how to run TTS migration commands but not the PostgreSQL privilege level required to execute them successfully. This update clarifies the required DB role to reduce migration failures caused by under-privileged users.

  • What changed

    • Added a warning note in Docker upgrade migration docs:
      • Path: doc/content/enterprise/docker/upgrading/_index.md
    • Clarified that migrations must run with:
      • the PostgreSQL role that owns existing TTS tables, or
      • a PostgreSQL superuser
    • Explicitly called out that migrations execute DDL (CREATE, ALTER, DROP), so read/write-only table grants are insufficient.
  • Doc example added

{{< warning >}}
For PostgreSQL deployments, run migrations with the same PostgreSQL role that owns the existing {{< tts >}} tables (or with a superuser role). Migrations execute DDL statements such as `CREATE`, `ALTER` and `DROP`, so a role with only read/write table privileges is not sufficient.
{{< /warning >}}

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • ttui.thethingsindustries.com
    • Triggering command: /usr/local/bin/node node /usr/local/bin/yarn --cwd doc -m elf_x86_64 --hash-style=gnu --as-needed -dynamic-linker /lib64/ld-linux-x86-64.so.2 -z relro -I /libsass @v0.139.4/config/tmp/go-build510302698/b572/ src/include -I om/bep/gowebp@v0--source 2o x64/pkg/tool/lin--destination (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Copilot AI changed the title [WIP] Add documentation for required Postgres permissions for TTS migrations Document required PostgreSQL role privileges for TTS database migrations Apr 23, 2026
Copilot AI requested a review from vlasebian April 23, 2026 13:15
@vlasebian vlasebian marked this pull request as ready for review June 10, 2026 09:14
@vlasebian vlasebian requested a review from KrishnaIyer as a code owner June 10, 2026 09:14
@vlasebian vlasebian marked this pull request as draft June 10, 2026 09:15
@vlasebian

Copy link
Copy Markdown
Contributor
Screenshot 2026-06-10 at 12 21 37

@vlasebian vlasebian marked this pull request as ready for review June 10, 2026 09:21
@vlasebian vlasebian merged commit 105d0fa into master Jun 12, 2026
1 check passed
@vlasebian vlasebian deleted the copilot/add-postgres-permissions-docs branch June 12, 2026 08:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants