SupabaseMeta

Overview

Postgres Meta is the Supabase REST API for managing Postgres metadata. Supabase Studio uses it to list schemas, tables, roles, extensions, policies, SQL results, and database settings.

Requirements

This template runs only the Postgres Meta service from the official Supabase Docker Compose stack. It requires a Supabase Postgres database that has been initialized with the official Supabase roles and schemas. Put Studio, Kong, Postgres Meta, and Postgres on the same custom Docker network, and make Studio's STUDIO_PG_META_URL point to this container, for example http://SupabaseMeta:8080 or a matching network alias. The current Supabase Docker release uses PG_META_DB_USER=supabase_admin; upcoming releases may switch fresh installs to postgres.

Runtime arguments

Network: bridge
Shell: sh
Privileged: false

Template configuration

API PortPorttcp

Optional Postgres Meta REST API port. Container port: 8080. Studio normally reaches this over the internal Docker network.

Target: 8080
Default: 8080
Value: 8080

Meta PortVariable

Port Postgres Meta listens on inside the container.

Target: PG_META_PORT
Default: 8080
Value: 8080

Postgres HostVariable

Hostname for the Supabase Postgres service as seen from Postgres Meta.

Target: PG_META_DB_HOST
Default: db
Value: db

Postgres PortVariable

Supabase Postgres or Supavisor session port.

Target: PG_META_DB_PORT
Default: 5432
Value: 5432

Postgres DatabaseVariable

Supabase Postgres database name.

Target: PG_META_DB_NAME
Default: postgres
Value: postgres

Postgres UserVariable

Database role used by Postgres Meta. Current self-hosted releases use supabase_admin; newer releases may use postgres after the ownership migration.

Target: PG_META_DB_USER
Default: supabase_admin
Value: supabase_admin

Postgres PasswordVariable

Database password generated for the Supabase stack.

Target: PG_META_DB_PASSWORD

Crypto KeyVariable

Postgres Meta encryption key. Use the same value as PG_META_CRYPTO_KEY from the Supabase .env file.

Target: CRYPTO_KEY

Links

Template Support Docker Hub Project

Details

Repository

supabase/postgres-meta:v0.96.3

Registry

https://hub.docker.com/r/supabase/postgres-meta

Last Updated2026-06-02

First Seen2026-05-24

Run SupabaseMeta on Unraid.

SupabaseMeta is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS