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

> Scopri come iniziare su Square Cloud con Node.js

## 🚀 Introduzione

* Prima di iniziare, assicurati che Node.js e npm siano installati sul tuo sistema. Se non li hai ancora, puoi scaricarli dal [sito ufficiale di Node.js](https://nodejs.org/).
* Successivamente, dovrai creare un account su Square Cloud, operazione che può essere effettuata tramite la [pagina di accesso](https://squarecloud.app/it/signup). Puoi usare 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

<Tabs>
  <Tab title="JavaScript">
    * Se il campo `START` non è definito nel file di configurazione, Square Cloud eseguirà di default `node` con opzioni di ottimizzazione e parametri specifici. Se il campo `START` è definito, verrà eseguito direttamente il valore in esso contenuto. Per maggiori informazioni sui parametri del file di configurazione, visita [parametri di configurazione](https://docs.squarecloud.app/it/getting-started/config-file#configuration-parameters).
  </Tab>

  <Tab title="TypeScript">
    * Se il campo `START` non è definito nel file di configurazione, Square Cloud eseguirà di default `npx tsx MAIN` per compilare ed eseguire il file TypeScript principale specificato in `MAIN`. Se il campo `START` è definito, verrà eseguito direttamente il valore in esso contenuto. Per maggiori informazioni sui parametri del file di configurazione, visita [parametri di configurazione](https://docs.squarecloud.app/it/getting-started/config-file#configuration-parameters).
  </Tab>
</Tabs>

* Se la cartella `node_modules` non esiste, Square Cloud eseguirà `npm install --no-package-lock --no-audit --no-fund` per installare le dipendenze e pulire la cartella `.npm`.

## 🖥️ Preparare il progetto

### 📁 File di configurazione essenziali

Quando prepari il tuo progetto Node.js 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

* `node_modules`: Questa cartella non deve essere caricata, poiché verrà ricreata durante l'installazione in produzione.
* `package-lock.json`: Questo file non è necessario, poiché l'ambiente di produzione installerà le dipendenze basandosi su `package.json`.

### 🤔 Perché escludere questi file?

Esistono diverse ragioni per escludere `node_modules` e `package-lock.json` prima di caricare il tuo progetto:

1. **Coerenza dell'installazione:** Non caricare `node_modules` garantisce che le dipendenze vengano installate dall'ambiente di produzione, risultando in una build coerente e priva di discrepanze del sistema locale.

2. **Installazioni aggiornate:** L'ambiente di produzione installerà le versioni compatibili più recenti delle dipendenze elencate in `package.json`, offrendo un punto di partenza pulito per la tua applicazione.

3. **Riduzione della dimensione del caricamento:** Non includere queste cartelle riduce la dimensione del file caricato, velocizzando il processo di caricamento e rendendo il deploy più efficiente.

Facendo così, ti assicuri che la tua applicazione Node.js sia preparata in modo ottimale per l'hosting su Square Cloud.

### 📄 File richiesti

Sono necessari tre file per ospitare il tuo progetto Node:

* [squarecloud.app/.config](https://docs.squarecloud.app/it/getting-started/config-file)
* mainFile.js/.ts (Esempio di file principale)
* [package.json](./how-to-create-your-package-json) (File delle dipendenze)

<Note>
  Square Cloud supporta `TypeScript` in modo nativo, eseguendo il tuo progetto tramite
  ts-node, ma è sempre consigliato compilare in `JavaScript`, poiché siamo
  una piattaforma di produzione.
</Note>

## 💡 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 o il percorso
    è sbagliato. Se il tuo file principale si trova all'interno di una cartella, ad
    esempio, devi specificare `folder/file.js`.
  </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 si arresti.
  </Accordion>
</AccordionGroup>

## 📤 Come ospitare il tuo progetto

Ora che hai preparato tutti i file per il tuo progetto Node.js, 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.