> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Primeros pasos en Square Cloud con C#

> Aprende cómo empezar en Square Cloud con C#

## 🚀 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](https://dotnet.microsoft.com/en-us/download).
* 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](https://squarecloud.app/es/signup). 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í](https://squarecloud.app/es/pricing).

## ⚙️ Configuración del archivo squarecloud.app

<Note>
  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.
</Note>

<Card title="Más información: cómo crear el archivo de configuración para Square Cloud." icon="link" href="https://docs.squarecloud.app/es/getting-started/config-file">
  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.
</Card>

## 📄 Archivos requeridos

* **project/project.csproj** (Ejemplo de archivo principal).
  <Note>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`</Note>
* [squarecloud.app](https://docs.squarecloud.app/es/getting-started/config-file) (archivo que contiene la configuración de Square Cloud).

## ▶️ Cómo iniciar tu aplicación

* Si el campo `START` no está definido en el archivo de configuración, Square Cloud usará por defecto el proceso `restore & run` para iniciar tu aplicación. Si el campo `START` está 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](https://docs.squarecloud.app/es/getting-started/config-file#configuration-parameters).

* Square Cloud usa `dotnet restore` para restaurar las dependencias del proyecto y `dotnet run --project MAIN` para compilar y ejecutar el proyecto especificado en `MAIN`.

## 🖥️ 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.

<Warning>El archivo de configuración (`squarecloud.app/.config`) debe estar ubicado en la raíz del archivo zip. De lo contrario, Square Cloud no podrá encontrarlo durante el deploy.</Warning>

## 📤 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

<Steps>
  <Step title="Accede a la página de subida">
    Accede a la [página de subida](https://squarecloud.app/es/dashboard/new) y sube el archivo zip de tu proyecto.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.

    <Frame>
      <img src="https://cdn.squarecloud.app/docs/articles/dashboard/uploading.gif" alt="Subiendo aplicación a Square Cloud" style={{ borderRadius: "0.2rem" }} />
    </Frame>
  </Step>
</Steps>

### A través de la CLI

Para usar este método, necesitas crear un archivo de configuración llamado `squarecloud.app` en el directorio raíz de tu proyecto. Este archivo contendrá la configuración necesaria para tu proyecto.

<Card title="Aprende más sobre: cómo crear el archivo de configuración para Square Cloud." icon="link" href="/es/getting-started/config-file">
  El archivo squarecloud.app es un archivo de configuración que se usará para configurar tu aplicación; se utilizará para definir tu entorno.
</Card>

<Steps>
  <Step title="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:

    ```
    npm install -g @squarecloud/cli
    ```

    Si ya la tienes, te recomendamos actualizarla. Para ello, ejecuta el siguiente comando en tu terminal:

    <Tabs>
      <Tab title="Windows">
        ```bash theme={null}
        squarecloud update
        ```
      </Tab>

      <Tab title="Linux, macOS y WSL">
        ```bash theme={null}
        curl -fsSL https://cli.squarecloud.app/install | bash
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Autentícate">
    Ahora, para autenticarte y usar otros comandos de la CLI, encontrarás tu clave de autorización [aquí](https://squarecloud.app/es/account/security) haciendo clic en "Request API Key". Después de obtener tu clave de autorización, ejecuta el siguiente comando:

    ```bash theme={null}
    squarecloud auth login
    ```
  </Step>

  <Step title="Sube tu proyecto">
    Por último, para desplegar tu aplicación en Square Cloud usando la CLI, necesitas ejecutar el siguiente comando:

    ```bash theme={null}
    squarecloud upload 
    ```

    O si creaste el zip manualmente, puedes usar:

    ```bash theme={null}
    squarecloud upload --file <path/to/zip> 
    ```
  </Step>
</Steps>

## Contáctanos

Si continúas enfrentando **dificultades técnicas**, nuestro **equipo de soporte especializado** está disponible para ayudarte. [**Contáctanos**](https://squarecloud.app/es/support) y estaremos encantados de ayudarte a resolver cualquier problema.