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

# Iniziare su Square Cloud con Python

> Scopri come iniziare su Square Cloud con Python

## 🚀 Introduzione

* Prima di iniziare, assicurati che Python sia installato sul tuo sistema. Se non lo hai ancora, puoi scaricarlo dal [sito ufficiale di Python](https://www.python.org/).
* Successivamente, dovrai creare un account su Square Cloud, operazione che puoi effettuare tramite la [pagina di accesso](https://squarecloud.app/it/signup). Puoi utilizzare la tua email, GitHub o entrambi per creare l'account.
* Infine, devi avere un piano a pagamento attivo sul tuo account. Puoi consultare i nostri piani e acquistarne uno in base alle tue esigenze [qui](https://squarecloud.app/it/pricing).

## ⚙️ Configurazione del file squarecloud.app

<Note>
  Se stai caricando la tua applicazione tramite il sito web di Square Cloud, puoi ignorare questa sezione. Il sito crea automaticamente il file di configurazione `squarecloud.app` per te.
</Note>

<Card title="Scopri di più: come creare il file di configurazione per Square Cloud." icon="link" href="https://docs.squarecloud.app/it/getting-started/config-file">
  Il file squarecloud.app è un file di configurazione che verrà utilizzato per
  configurare la tua applicazione; servirà a definire il nome, la descrizione,
  la versione, il file principale, tra le altre cose.
</Card>

## 📄 File richiesti

* Se il campo `START` non è definito nel file di configurazione, Square Cloud eseguirà `python MAIN` per avviare il file Python specificato in `MAIN`. Se il campo `START` è definito nel file di configurazione, il valore in esso contenuto verrà eseguito direttamente. Per maggiori informazioni sui parametri del file di configurazione, visita [parametri di configurazione](https://docs.squarecloud.app/it/getting-started/config-file#configuration-parameters).

* Square Cloud utilizza `pip install` per installare tutte le dipendenze elencate in `requirements.txt`.

## 🖥️ Preparazione del progetto

### 📁 File di configurazione essenziali

Quando prepari il tuo progetto Python per il deploy su Square Cloud, assicurati di includere il file di configurazione (`squarecloud.app/.config`) e i file essenziali della tua applicazione all'interno di un file zip.

<Warning>Il file di configurazione (`squarecloud.app/.config`) deve trovarsi nella radice del file zip. In caso contrario, Square Cloud non sarà in grado di trovarlo durante il deploy.</Warning>

#### 🗑️ File da escludere prima del caricamento

* `ffmpeg`: Questo software è preinstallato nell'ambiente di Square Cloud, quindi non è necessario includerlo nel tuo progetto.
* `.venv`: Questa cartella contiene l'ambiente virtuale del tuo progetto. Square Cloud fornisce un ambiente isolato, quindi non è necessario caricare questa cartella.
* `poetry.lock`: Poiché Square Cloud attualmente non supporta Poetry, questo file dovrebbe essere escluso per evitare problemi di compatibilità durante il deploy.

### 🤔 Perché escludere questi file?

Escludere `ffmpeg`, `.venv` e `poetry.lock` è importante per diverse ragioni:

1. **Ambiente pulito:** Square Cloud crea un nuovo ambiente per il tuo progetto. Includere questi file è superfluo e potrebbe causare conflitti con le configurazioni dell'ambiente cloud.

2. **Efficienza:** La rimozione di questi file riduce la dimensione del caricamento, rendendo il processo più veloce e leggero.

3. **Compatibilità:** L'esclusione di `poetry.lock` evita problemi di compatibilità, poiché Square Cloud utilizza `requirements.txt` per installare le dipendenze.

Prima del caricamento, comprimi i file del tuo progetto nel formato **.zip**, escludendo i file non necessari menzionati sopra. Questo aiuterà a garantire che la tua applicazione Python sia pronta per un deploy di successo su Square Cloud.

### 📄 File richiesti

* main.py (Esempio di file principale).
* [requirements.txt](./how-to-create-your-requirements) (File delle dipendenze).
* OPPURE \[pyproject.toml] (File delle dipendenze).
* [squarecloud.app](https://docs.squarecloud.app/it/getting-started/config-file) (file contenente la configurazione di Square Cloud).

## 💡 Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="Il file principale non è valido o è corrotto" icon="file" iconType="solid">
    Questo errore si verifica quando il file definito come "main" per la tua applicazione
    nel file di configurazione non esiste, è scritto in modo errato, oppure il
    percorso è errato. Se il tuo file principale si trova all'interno di una
    cartella, ad esempio, specifica `folder/file.py`.
  </Accordion>

  <Accordion title="Memoria insufficiente" icon="memory" iconType="solid">
    La quantità minima di RAM richiesta per ospitare un bot è 256MB e per
    un sito/API è 512MB. Tuttavia, a seconda della dimensione e della complessità della
    tua applicazione, potrebbe essere consigliabile allocare una quantità maggiore di RAM per
    evitare che la tua applicazione esaurisca la memoria e vada in crash.
  </Accordion>
</AccordionGroup>

## 📤 Come ospitare il tuo progetto

Ora che hai preparato tutti i file per il tuo progetto Python, il passo successivo è caricarli su Square Cloud e mettere online la tua applicazione. Esistono diversi modi per effettuare il caricamento, ma ne tratteremo due: tramite Dashboard o tramite CLI.

### Tramite dashboard

<Steps>
  <Step title="Accedi alla pagina di upload">
    Accedi alla [pagina di upload](https://squarecloud.app/it/dashboard/new) e carica il file zip del tuo progetto.
  </Step>

  <Step title="Configura il tuo ambiente">
    Dopo aver caricato il tuo zip, dovrai configurare il nome, il file principale o il runtime environment e altre impostazioni per il tuo progetto.\
    Se stai caricando un progetto web, assicurati di selezionare "Web Publication" e di impostare un sottodominio per il tuo progetto.
  </Step>

  <Step title="Esegui il deploy del tuo progetto">
    Infine, clicca sul pulsante "Deploy" per ospitare il tuo progetto su Square Cloud.\
    Dopo il deploy, puoi monitorare lo stato e i log del tuo progetto dalla dashboard.

    <Frame>
      <img src="https://cdn.squarecloud.app/docs/articles/dashboard/uploading.gif" alt="Caricamento dell'applicazione su Square Cloud" style={{ borderRadius: "0.2rem" }} />
    </Frame>
  </Step>
</Steps>

### Tramite CLI

Per utilizzare questo metodo, devi creare un file di configurazione chiamato `squarecloud.app` nella directory principale del tuo progetto. Questo file conterrà la configurazione necessaria per il tuo progetto.

<Card title="Scopri di più su: come creare il file di configurazione per Square Cloud." icon="link" href="/it/getting-started/config-file">
  Il file squarecloud.app è un file di configurazione che verrà utilizzato per configurare la tua applicazione; verrà usato per definire il tuo ambiente.
</Card>

<Steps>
  <Step title="Installa la CLI">
    Per prima cosa, devi avere la CLI installata nel tuo ambiente. Se non la hai ancora, esegui il seguente comando nel tuo terminale:

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

    Se la hai già, ti consigliamo di aggiornarla. Per farlo, esegui il seguente comando nel tuo terminale:

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

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

  <Step title="Autenticati">
    Ora, per autenticarti e utilizzare gli altri comandi della CLI, troverai la tua chiave di autorizzazione [qui](https://squarecloud.app/it/account/security) cliccando su "Request API Key". Dopo aver ottenuto la tua chiave di autorizzazione, esegui il seguente comando:

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

  <Step title="Carica il tuo progetto">
    Infine, per eseguire il deploy della tua applicazione su Square Cloud tramite la CLI, devi eseguire il seguente comando:

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

    Oppure, se hai creato lo zip manualmente, puoi usare:

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

## Contattaci

Se continui a riscontrare **difficoltà tecniche**, il nostro **team di supporto specializzato** è disponibile ad assisterti. [**Contattaci**](https://squarecloud.app/it/support) e saremo felici di aiutarti a risolvere qualsiasi problema.