Introducción
Para desarrollar y alojar una aplicación Django 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.
Crear el proyecto
Necesitas Python y pip en tu máquina. Si no los tienes, descarga Python desde el sitio oficial de Python.Instalar las bibliotecas
Instala Django, el servidor de producción Gunicorn y WhiteNoise, que sirve tus archivos estáticos:Desarrollar el proyecto
Crea un nuevo proyecto Django y entra en su carpeta:manage.py y un paquete mysite/ con settings.py, urls.py y wsgi.py. Para añadir una ruta básica, edita mysite/urls.py:
mysite/urls.py
Configurar los ajustes para producción
Nunca escribas secretos directamente en tu código. Enmysite/settings.py, lee la clave secreta y los indicadores de producción desde variables de entorno, confía en el origen HTTPS de tu sitio y activa WhiteNoise. Deja el resto de los ajustes generados como están:
mysite/settings.py
mysite.squareweb.app por tu subdominio o dominio personalizado. Luego define estas variables de entorno en tu aplicación, desde el dashboard o con squarecloud app env set:
Para ejecutar el proyecto en local, define
DJANGO_SECRET_KEY (cualquier valor) y DJANGO_DEBUG=True en tu terminal y luego ejecuta python manage.py runserver.requirements.txt junto a manage.py. Square Cloud las instala con pip antes de iniciar la app. Debe incluir como mínimo:
requirements.txt
Elegir un servidor de producción
El servidor de desarrollo integrado de Django (runserver) no es adecuado para uso en producción. Usa Gunicorn, un servidor WSGI listo para producción, iniciado por el comando START de abajo. Para la configuración de workers y otras opciones, consulta la guía de Gunicorn:
Gunicorn
Gunicorn es un servidor HTTP WSGI de Python para UNIX. Utiliza un modelo de workers pre-fork, lo que significa que crea múltiples procesos worker para gestionar las solicitudes.
Esto lo convierte en una excelente opción para ejecutar aplicaciones web de Python en producción.
Puerto y host
El comandoSTART de abajo hace bind de Gunicorn a 0.0.0.0:80: todas las interfaces de red, en el puerto que Square Cloud enruta a tu app. Django en sí no tiene ningún ajuste de puerto que cambiar.
Configurar Square Cloud
Crea un archivosquarecloud.app junto a manage.py:
squarecloud.app
collectstaticcopia tus archivos estáticos aSTATIC_ROOT, desde donde WhiteNoise los sirve.migrateaplica las migraciones pendientes de la base de datos. No hace nada cuando la base de datos ya está actualizada.python -m gunicorn mysite.wsgi --bind 0.0.0.0:80sirve la aplicación WSGI del proyectomysiteen el puerto 80 y en todas las interfaces de red.
MAIN=manage.py selecciona el runtime de Python. Al subir por el dashboard, define el mismo archivo principal y comando de inicio.
Qué va en el ZIP
manage.pyy el paquetemysite/, con tus apps y plantillas.requirements.txt.squarecloud.app.
manage.py, requirements.txt y squarecloud.app deben estar en la raíz del ZIP. Deja fuera .venv, __pycache__, staticfiles/ (que collectstatic regenera en cada inicio) y tu db.sqlite3 local.
Hacer deploy y verificar
A través del panel
1
Accede a la página de subida
Accede a la página de subida y sube el archivo zip de tu proyecto.
2
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.
Si estás subiendo un proyecto web, asegúrate de seleccionar “Publicación Web” y de definir un subdominio para tu proyecto.
3
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.
Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel.

4
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
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.
A través de la CLI
Para usar este método, tu proyecto necesita un archivo de configuración llamadosquarecloud.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.1
Instala la CLI
Instala la CLI de Square Cloud. Si ya la tienes, ejecuta el mismo comando para actualizarla:
2
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.
3
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 Para subir un zip que creaste tú mismo, pásalo con
squarecloud.ignore, y lo sube:--file:4
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: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.
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.KeyError: ‘DJANGO_SECRET_KEY’
Falta la variable de entorno. DefineDJANGO_SECRET_KEY como se muestra en Configurar los ajustes para producción y reinicia la aplicación.
Bad Request (400)
La dirección que abriste no está enDJANGO_ALLOWED_HOSTS. Añade tu subdominio o dominio personalizado y reinicia la aplicación.
Próximos pasos
Variables de entorno
Mantén secretos y ajustes fuera de tu código y léelos en tiempo de ejecución.
Dominio personalizado
Sirve tu app en tu propio dominio, desde el plan Standard.
Solución de problemas
Arregla una app que no inicia o un sitio que no responde.

