Aloja pgAdmin 4 para tu base de datos PostgreSQL

Introducción

Para desarrollar y alojar una instancia de pgAdmin en Square Cloud, es esencial seguir una secuencia estructurada de configuraciones y requisitos previos. Esta guía técnica cubrirá todo el proceso, desde la configuración inicial hasta el despliegue en producción.

Requisitos previos

Cuenta de Square Cloud: Regístrate a través de la página de registro usando tu correo electrónico.
Plan activo: Garantiza recursos dedicados y un rendimiento optimizado para tu aplicación. Consulta nuestros planes disponibles y elige el más adecuado para tus necesidades.

Esta guía usa el runtime de Python.

Obtener el proyecto

pgAdmin se ejecuta en Python, así que el proyecto necesita un requirements.txt o un pyproject.toml (consulta cómo crear un requirements.txt). Lista pgadmin4 y un servidor web para servirlo. Esta guía usa gunicorn:

requirements.txt

pgadmin4==9.18
gunicorn==26.2.0

Las versiones están fijadas, como en nuestra release lista para usar, para que una reinstalación nunca salte a una versión nueva con cambios incompatibles. Para actualizar más adelante, cámbialas aquí y vuelve a subir tu proyecto. A continuación, crea un archivo config_local.py. pgAdmin lo lee al iniciar: estos ajustes lo ejecutan como servidor web y guardan sus datos, su log y su base de datos SQLite en una carpeta .pgadmin dentro de tu aplicación.

config_local.py

SERVER_MODE = True
MAX_LOGIN_ATTEMPTS = 3
"""
    CRITICAL 50
    ERROR    40
    WARNING  30
    SQL      25
    INFO     20
    DEBUG    10
    NOTSET    0
"""
CONSOLE_LOG_LEVEL = 10
DATA_DIR = "/application/.pgadmin/"
LOG_FILE = "/application/.pgadmin/logfile"
SQLITE_PATH = '/application/.pgadmin/pgadmin4.db'

Ya tenemos todo listo para el deploy en nuestras releases de pgadmin4-web. Solo necesitas descargar el project.zip, rellenar las dos variables de abajo y subirlo.

Configurar Square Cloud

Crea un archivo squarecloud.app en la raíz de tu proyecto:

squarecloud.app

DISPLAY_NAME=App name
RUNTIME=python
MEMORY=1024
START=python -m gunicorn --bind 0.0.0.0:80 --workers=1 --threads=4 pgadmin4.pgAdmin4:app
VERSION=recommended
SUBDOMAIN=my-pgadmin-subdomain

Gunicorn escucha en el puerto 80 en todas las interfaces (0.0.0.0), donde Square Cloud entrega el tráfico de tu subdominio. Mantén un solo worker (--workers=1) y añade threads: con más workers, pgAdmin falla con errores de CSRF. Al subir desde el dashboard, define manualmente el runtime como Python y usa el mismo comando START como comando de inicio.

Variables de entorno

Define 2 variables de entorno, PGADMIN_SETUP_EMAIL y PGADMIN_SETUP_PASSWORD. pgAdmin las usa para crear el primer usuario cuando se inicia por primera vez.

.env

PGADMIN_SETUP_EMAIL=accessemail@example.com
PGADMIN_SETUP_PASSWORD=yourSecurePassword

Defínelas en la Configuración avanzada del formulario de subida, en la página Variables de entorno de la aplicación (y luego reiníciala) o con squarecloud app env set. pgAdmin no lee un archivo .env en la raíz de tu proyecto, así que estos valores solo funcionan como variables de entorno. Consulta Variables de entorno.

Qué va en el ZIP

requirements.txt o pyproject.toml
config_local.py
squarecloud.app

Hacer deploy y verificar

A través del panel

Accede a la página de subida

Accede a la página de subida y sube el archivo zip de tu proyecto.

Configura tu entorno

Después de subir tu zip, deberás configurar el nombre, el archivo principal o el entorno de ejecución y otros ajustes de tu proyecto.
Si estás subiendo un proyecto web, asegúrate de seleccionar “Publicación Web” y de definir un subdominio para tu proyecto.

Despliega tu proyecto

Por último, haz clic en el botón “Deploy” para alojar tu proyecto en Square Cloud.
Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel.

Confirma que tu aplicación esté en vivo

Tu primer despliegue suele tardar menos de un minuto. En el dashboard, espera a que el estado de tu aplicación muestre “running” y revisa los logs por si hay errores de inicio.
Si desplegaste un sitio web o una API, abre https://<tu-subdominio>.squareweb.app en tu navegador: deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online.

¿La aplicación no inicia? Consulta la guía de solución de problemas para ver las causas y soluciones más comunes.

A través de la CLI

Para usar este método, tu proyecto necesita un archivo de configuración llamado squarecloud.app en su raíz. Le indica a Square Cloud cómo ejecutar tu aplicación.

Guía del archivo de configuración

Aprende a crear el archivo de configuración squarecloud.app que define el entorno de tu aplicación.

Instala la CLI

Instala la CLI de Square Cloud. Si ya la tienes, ejecuta el mismo comando para actualizarla:

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

Inicia sesión

Ejecuta el comando de abajo. Abre tu navegador: aprueba el inicio de sesión allí y la CLI queda lista. No hay ninguna clave de API que copiar. Para scripts y CI, consulta autenticación de la CLI.

squarecloud auth login

Sube tu proyecto

Desde la carpeta de tu proyecto, ejecuta el comando de abajo. La CLI comprime la carpeta actual en un zip, dejando fuera lo que lista squarecloud.ignore, y lo sube:

squarecloud upload

Para subir un zip que creaste tú mismo, pásalo con --file:

squarecloud upload --file <path/to/zip>

Confirma que tu aplicación esté en vivo

Tu primer despliegue suele tardar menos de un minuto. Revisa el estado y los logs de tu aplicación directamente desde la terminal:

squarecloud app status
squarecloud app logs

Si desplegaste un sitio web o una API, abre https://<tu-subdominio>.squareweb.app en tu navegador: deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online.

¿La aplicación no inicia? Consulta la guía de solución de problemas para ver las causas y soluciones más comunes.

Primer acceso

Abre https://my-pgadmin-subdomain.squareweb.app e inicia sesión con el correo y la contraseña que definiste. Luego añade tu servidor PostgreSQL para gestionarlo desde cualquier lugar.

Errores comunes

Dominio personalizado

Para usar un dominio personalizado (por ejemplo, mysite.com) en lugar de la URL predeterminada mysite.squareweb.app, necesitas el plan Standard o superior. La URL predeterminada sale del campo SUBDOMAIN del archivo de configuración. Para conectar tu dominio, sigue cómo configurar tu propio dominio.

Requisitos mínimos de RAM

Mínimo: 512MB de RAM para sitios web y APIs, suficiente para un build estático en el runtime estático. Para apps que renderizan páginas en un servidor (Next.js, Nuxt, Angular SSR y similares), recomendamos al menos 1GB de RAM. Para aplicaciones más grandes, asigna más RAM para evitar que la aplicación se quede sin memoria y falle.

No se pudo encontrar este sitio.

Verifica que el subdominio/dominio coincida con lo configurado en el campo SUBDOMAIN o en la configuración del dominio personalizado. Si acabas de subir el sitio, espera hasta 60 segundos para que Square habilite el primer acceso.

El sitio tardó demasiado en responder…

Tu servidor debe escuchar en el puerto 80 y el host 0.0.0.0. Square Cloud define las variables de entorno PORT (80) y HOST (0.0.0.0) en tu aplicación: léelas en tu código en lugar de fijar otros valores. Un servidor que escucha solo en localhost o 127.0.0.1 nunca recibe solicitudes.

Errores de CSRF después de iniciar sesión

pgAdmin se ejecuta con más de un worker de Gunicorn. Define --workers=1 en el comando START, añade threads con --threads si necesitas más capacidad y luego reinicia la aplicación.

Próximos pasos

Base de datos gestionada

Crea una base de datos PostgreSQL para gestionarla con pgAdmin.

Errores de conexión a la base de datos

Soluciona errores de SSL/TLS y de conexión.

Gunicorn

Ajusta el servidor web que ejecuta pgAdmin.

Para más información sobre pgAdmin, consulta la documentación oficial de pgAdmin.

Contáctanos

Si continúas enfrentando dificultades técnicas, nuestro equipo de soporte especializado está disponible para ayudarte. Contáctanos y estaremos encantados de ayudarte a resolver cualquier problema: la calidad del soporte es una gran parte de por qué los desarrolladores califican a Square Cloud con 4.9/5 en 402 reseñas en Google y Trustpilot.

Bots

Sitios web

APIs y backends

Bases de datos

Aplicaciones autoalojadas

Guías

Guías de migración

Aloja pgAdmin 4 para tu base de datos PostgreSQL

Introducción

Requisitos previos

Obtener el proyecto

Configurar Square Cloud

Variables de entorno

Qué va en el ZIP

Hacer deploy y verificar

A través del panel

A través de la CLI

Guía del archivo de configuración

Primer acceso

Errores comunes

Dominio personalizado

Requisitos mínimos de RAM

No se pudo encontrar este sitio.

El sitio tardó demasiado en responder…

Errores de CSRF después de iniciar sesión

Próximos pasos

Base de datos gestionada

Errores de conexión a la base de datos

Gunicorn

Contáctanos

​Introducción

​Requisitos previos

​Obtener el proyecto

​Configurar Square Cloud

​Variables de entorno

​Qué va en el ZIP

​Hacer deploy y verificar

​A través del panel

​A través de la CLI

Guía del archivo de configuración

​Primer acceso

​Errores comunes

​Dominio personalizado

​Requisitos mínimos de RAM

​No se pudo encontrar este sitio.

​El sitio tardó demasiado en responder…

​Errores de CSRF después de iniciar sesión

​Próximos pasos

Base de datos gestionada

Errores de conexión a la base de datos

Gunicorn

​Contáctanos

Introducción

Requisitos previos

Obtener el proyecto

Configurar Square Cloud

Variables de entorno

Qué va en el ZIP

Hacer deploy y verificar

A través del panel

A través de la CLI

Primer acceso

Errores comunes

Dominio personalizado

Requisitos mínimos de RAM

No se pudo encontrar este sitio.

El sitio tardó demasiado en responder…

Errores de CSRF después de iniciar sesión

Próximos pasos

Contáctanos