🚀 Introducción
- Antes de empezar, asegúrate de tener .NET (Dotnet) instalado en tu sistema. Si aún no lo tienes, puedes descargarlo desde el sitio oficial de Dotnet.
- A continuación, tendrás que crear una cuenta en Square Cloud, lo cual puedes hacer a través de la página de inicio de sesión. Puedes usar tu correo electrónico, GitHub o ambos para crear la cuenta.
- Por último, necesitas tener un plan de pago activo en tu cuenta. Puedes ver nuestros planes y adquirir uno según tus necesidades aquí.
⚙️ Configuración del archivo squarecloud.app
Si estás subiendo tu aplicación a través del sitio web de Square Cloud, puedes ignorar esta sección. El sitio crea automáticamente el archivo de configuración
squarecloud.app por ti.Más información: cómo crear el archivo de configuración para Square Cloud.
El archivo squarecloud.app es un archivo de configuración que se usará para
configurar tu aplicación; servirá para definir el nombre, la descripción,
la versión, el archivo principal, entre otras cosas.
📄 Archivos requeridos
- project/project.csproj (Ejemplo de archivo principal).
En el ejemplo anterior, el archivo principal de la aplicación está dentro de una carpeta. Si tu archivo de configuración también está dentro de una carpeta, debes definir la ruta en el campo
MAIN, por ejemplo:MAIN=folder/file.csproj - squarecloud.app (archivo que contiene la configuración de Square Cloud).
▶️ Cómo iniciar tu aplicación
-
Si el campo
STARTno está definido en el archivo de configuración, Square Cloud usará por defecto el procesorestore & runpara iniciar tu aplicación. Si el campoSTARTestá definido, el valor que contenga se ejecutará directamente. Para más información sobre los parámetros del archivo de configuración, visita parámetros de configuración. -
Square Cloud usa
dotnet restorepara restaurar las dependencias del proyecto ydotnet run --project MAINpara compilar y ejecutar el proyecto especificado enMAIN.
🖥️ Preparando el proyecto
Antes de alojar tu proyecto en Square Cloud, primero verifica si los archivos del proyecto están configurados correctamente para el alojamiento.📤 Cómo alojar tu proyecto
Ahora que has preparado todos los archivos de tu proyecto C#, el siguiente paso es subirlos a Square Cloud y poner tu aplicación en línea. Hay varias formas de subirlos, pero cubriremos dos: mediante el Dashboard o mediante la CLI.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, necesitas crear un archivo de configuración llamadosquarecloud.app en el directorio raíz de tu proyecto. Este archivo contendrá la configuración necesaria para tu proyecto.
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
Primero, necesitas tener la CLI instalada en tu entorno. Si aún no la tienes, ejecuta el siguiente comando en tu terminal:Si ya la tienes, te recomendamos actualizarla. Para ello, ejecuta el siguiente comando en tu terminal:
- Windows
- Linux, macOS y WSL
2
Autentícate
Ahora, para autenticarte y usar otros comandos de la CLI, encontrarás tu clave de autorización aquí haciendo clic en “Request API Key”. Después de obtener tu clave de autorización, ejecuta el siguiente comando:
3
Sube tu proyecto
Por último, para desplegar tu aplicación en Square Cloud usando la CLI, necesitas ejecutar el siguiente comando:O si creaste el zip manualmente, puedes usar:
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.

