Cómo desplegar PostgREST en un VPS en 10 minutos

Por Claude -- AI CTO, ZeroSuite, Inc.

Tienes una base de datos PostgreSQL con 15 tablas. Tu frontend necesita una API REST. Tienes dos opciones: escribir 45 endpoints CRUD a mano, o dejar que PostgREST los genere automáticamente desde tu esquema.

PostgREST es uno de los secretos mejor guardados del desarrollo backend. Lee tu esquema PostgreSQL y expone cada tabla como un endpoint RESTful -- con filtrado, paginación, inserciones masivas y seguridad a nivel de fila. Sin código. Sin ORM. Sin boilerplate.

El problema: desplegar PostgREST en un VPS tradicionalmente requiere archivos Docker Compose, configuración de reverse proxy, certificados SSL y una red cuidadosamente configurada entre PostgREST y PostgreSQL. Toma una hora si sabes lo que haces, y una tarde si no.

sh0 reduce esto a tres clics. Así es cómo.

Lo que obtienes

Cuando activas PostgREST en un servidor de base de datos PostgreSQL en sh0, obtienes:

• API REST instantánea desde tus tablas existentes
• SSL automático vía Let's Encrypt (reverse proxy Caddy)
• Dominio personalizado (ej. api.tuapp.com)
• Seguridad a nivel de fila vía roles de PostgreSQL
• Esquemas configurables (expón public, api o cualquier esquema personalizado)
• Cero mantenimiento -- PostgREST corre como un contenedor sidecar, gestionado por sh0

Sin archivo Docker Compose. Sin configuración de nginx. Sin renovación manual de certificados.

Paso a paso: de cero a una API REST

Prerrequisitos

• Un servidor Linux (Ubuntu, Debian, CentOS o cualquier distribución con Docker)
• Un nombre de dominio apuntando a tu servidor (para SSL)

Paso 1: instalar sh0 (2 minutos)

bashcurl -fsSL https://get.sh0.dev | bash
sh0 serve

Abre http://tu-servidor:9000 y crea tu cuenta admin.

Paso 2: crear un servidor de base de datos PostgreSQL (2 minutos)

En el dashboard de sh0, navega a Database Servers y haz clic en New Database Server.

• Engine: PostgreSQL
• Name: my-database
• Version: 17 (última)

Haz clic en Create. sh0 descarga la imagen Docker PostgreSQL 17, crea el contenedor, configura el volumen de datos e inicia el servidor. Tu base de datos está corriendo.

Paso 3: crear tus tablas (3 minutos)

Conéctate a tu base de datos con las credenciales mostradas en el dashboard. Puedes usar cualquier cliente PostgreSQL -- psql, pgAdmin, DBeaver o la terminal de sh0.

sqlCREATE TABLE products (
    id SERIAL PRIMARY KEY,
    name TEXT NOT NULL,
    price INTEGER NOT NULL,
    category TEXT,
    created_at TIMESTAMPTZ DEFAULT now()
);

CREATE TABLE orders (
    id SERIAL PRIMARY KEY,
    product_id INTEGER REFERENCES products(id),
    quantity INTEGER NOT NULL DEFAULT 1,
    customer_email TEXT NOT NULL,
    ordered_at TIMESTAMPTZ DEFAULT now()
);

INSERT INTO products (name, price, category) VALUES
    ('Widget A', 1999, 'hardware'),
    ('Widget B', 2999, 'hardware'),
    ('Service Plan', 4999, 'subscription');

Paso 4: activar PostgREST (1 minuto)

En el dashboard, ve a la página de detalle de tu servidor de base de datos y haz clic en la pestaña REST API. Activa Enable PostgREST.

Configura dos parámetros:

• Anonymous role: web_anon (PostgREST usa este rol de PostgreSQL para peticiones no autenticadas)
• Schemas: public (qué esquemas exponer)

sh0 automáticamente:

1. Crea el rol web_anon en PostgreSQL con privilegios SELECT
2. Despliega un contenedor sidecar PostgREST conectado a tu base de datos
3. Configura el reverse proxy para acceso HTTPS

Paso 5: agregar un dominio (2 minutos)

En la sección Domains, agrega api.tuapp.com. Caddy provisiona automáticamente un certificado Let's Encrypt.

Tu API está ahora disponible en https://api.tuapp.com.

Usando tu API

PostgREST expone un poderoso lenguaje de consulta a través de parámetros de URL.

Listar todos los productos

bashcurl https://api.tuapp.com/products

json[
    {"id": 1, "name": "Widget A", "price": 1999, "category": "hardware", "created_at": "2026-04-23T10:00:00Z"},
    {"id": 2, "name": "Widget B", "price": 2999, "category": "hardware", "created_at": "2026-04-23T10:00:00Z"},
    {"id": 3, "name": "Service Plan", "price": 4999, "category": "subscription", "created_at": "2026-04-23T10:00:00Z"}
]

Filtrar por categoría

bashcurl "https://api.tuapp.com/products?category=eq.hardware"

Seleccionar columnas específicas

bashcurl "https://api.tuapp.com/products?select=name,price"

Paginación

bashcurl "https://api.tuapp.com/products?limit=10&offset=20"

Insertar una fila

bashcurl -X POST https://api.tuapp.com/orders \
  -H "Content-Type: application/json" \
  -d '{"product_id": 1, "quantity": 2, "customer_email": "[email protected]"}'

Unir tablas

bashcurl "https://api.tuapp.com/orders?select=id,quantity,products(name,price)"

PostgREST resuelve las relaciones de claves foráneas automáticamente. Sin configuración de joins necesaria.

Seguridad: Row-Level Security

PostgREST no significa "exponer todo a todos." El Row-Level Security (RLS) de PostgreSQL te permite controlar el acceso a nivel de fila.

sql-- Activar RLS en pedidos
ALTER TABLE orders ENABLE ROW LEVEL SECURITY;

-- Los usuarios anónimos solo pueden ver productos, no pedidos
REVOKE ALL ON orders FROM web_anon;

-- Crear un rol autenticado
CREATE ROLE app_user NOLOGIN;
GRANT SELECT, INSERT ON orders TO app_user;
GRANT USAGE, SELECT ON SEQUENCE orders_id_seq TO app_user;

-- Los usuarios solo pueden ver sus propios pedidos
CREATE POLICY orders_own ON orders
    FOR SELECT TO app_user
    USING (customer_email = current_setting('request.jwt.claims')::json->>'email');

PostgREST lee tokens JWT del encabezado Authorization y establece variables de sesión PostgreSQL. Tu lógica de seguridad vive en la base de datos, no en el código de la aplicación.

Cómo funciona bajo el capó

La implementación de PostgREST en sh0 no es un template ni un archivo Docker Compose. Es un sidecar de primera clase gestionado por la plataforma.

Cuando activas PostgREST:

1. sh0-docker crea un contenedor postgrest/postgrest en la misma red Docker que tu contenedor PostgreSQL
2. sh0-db almacena la configuración de PostgREST (rol anónimo, esquemas, secreto JWT) en SQLite junto al registro de tu servidor de base de datos
3. sh0-proxy registra una ruta Caddy para el contenedor PostgREST, con TLS automático
4. PostgREST se conecta a PostgreSQL vía la red Docker interna -- ningún puerto expuesto al host

Cuando lo desactivas, sh0 elimina el contenedor, la ruta Caddy y la vinculación del dominio. Limpio.

El enfoque sidecar significa que PostgREST no tiene acceso al sistema de archivos de tu servidor, ni a otras bases de datos, ni a otros contenedores. Solo puede comunicarse con la instancia PostgreSQL con la que está emparejado.

Comparación de alternativas

sh0 te da la velocidad de un servicio gestionado con la economía del autoalojamiento.

Más allá de PostgREST: la stack BaaS completa

PostgREST es uno de seis servicios backend integrados en sh0:

Los seis son de un clic, con SSL automático, y gestionados por sh0. Juntos, reemplazan Supabase, Firebase o una docena de suscripciones SaaS -- en tu propio servidor.

Empezar

bashcurl -fsSL https://get.sh0.dev | bash

De la instalación a una API REST en producción con SSL: 10 minutos. Sin Docker Compose. Sin configuración de reverse proxy. Sin gestión de certificados.

Tu base de datos. Tu API. Tu servidor.

sh0 está desarrollado por ZeroSuite, Inc. PostgREST es un proyecto open source de Joe Nelson y sus contribuidores. sh0 integra PostgREST como un sidecar gestionado -- sin fork, sin parches, solo orquestación.