# Windows

> Installa evcc manualmente su Windows, eseguilo dal prompt dei comandi o come servizio in background, aggiornalo o torna a una versione precedente.

Qui trovi le istruzioni per installare evcc manualmente su Windows.

> **Attenzione**
>
> Questa installazione manuale richiede conoscenze informatiche avanzate, soprattutto nell’uso del prompt dei comandi o di PowerShell.
>
> È possibile eseguire evcc su Windows. Di solito però evcc viene usato in un ambiente Linux (ad es. Raspberry Pi).

## Installazione

1. ### Installa

   Scarica il file adatto al tuo sistema ed estrailo (ad es. con un doppio clic):

   * CPU Intel a 64 bit: [evcc_X.XX_windows_amd64.zip](https://github.com/evcc-io/evcc/releases/latest)

   Apri il prompt dei comandi e vai nella cartella estratta. Verifica l’installazione:

   ```sh
   evcc -v
   ```

   Dovresti vedere la versione attuale di evcc (ad es. `evcc version 0.xxx.y`).

2. ### Avvia

   ```sh
   ./evcc
   ```

3. ### Configura

   Apri l’interfaccia web di evcc nel browser: <http://localhost:7070>. Imposta una password di amministratore e configura i tuoi dispositivi direttamente dall’interfaccia web.

## File di configurazione (alternativa)

In alternativa all’interfaccia web puoi usare un file di configurazione `evcc.yaml`. Per i dettagli consulta [Configurazione](/it/installation/configuration).

Avvia evcc con:

```sh
./evcc -c evcc.yaml
```

## Aggiornamento e downgrade

Segui i passaggi descritti sopra e sostituisci il file del programma evcc con la versione nuova o precedente. Non è necessario ripetere la configurazione.

## Servizio in background

### Utilità di pianificazione

> **Nota**
>
> Questa guida presuppone che evcc si trovi in `c:\evcc`.
>
> Queste istruzioni si riferiscono a Windows 10.

* Apri il menu Start e cerca “Utilità di pianificazione”, poi fai clic con il tasto destro e scegli “Esegui come amministratore”:

![Utilità di pianificazione di Windows 10](/_astro/win10-srv-1.BQfo4Mab_Z1atspj.webp)

* Dopo aver avviato l’Utilità di pianificazione, scegli se creare il nuovo servizio in una cartella dedicata o nella “Libreria Utilità di pianificazione” generale. In questo esempio creiamo una cartella `evcc` dedicata. Seleziona “Libreria Utilità di pianificazione”, poi fai clic con il tasto destro per aprire il menu contestuale e scegli “Nuova cartella…”:

![Libreria Utilità di pianificazione](/_astro/win10-srv-2.BvLQnUHf_1Pz5ad.webp)

* Ora seleziona la nuova cartella `evcc` e apri di nuovo il menu contestuale. Scegli “Crea attività”:

![Finestra Nuova attività](/_astro/win10-srv-3.Bem2aFTu_1pt2Xc.webp)

* Assegna un nome all’attività (ad es. “evcc”) e una breve descrizione. Poiché l’attività deve essere eseguita come servizio di sistema, apri la gestione utenti con “Cambia utente o gruppo” e inserisci `SYSTEM` nella casella. Fai clic su “Controlla nomi”: la parola “SYSTEM” dovrebbe risultare sottolineata. Fai clic su OK per chiudere la finestra di dialogo:

![Finestra dell’attività](/_astro/win10-srv-4.ZgX5SuZj_Z1mM5I1.webp) ![Selezione utente](/_astro/win10-srv-5.CBq4gGTQ_Z1G9HJx.webp)

* Nella scheda “Attivazione” fai clic su “Nuovo…”. Imposta l’attivazione su “All’avvio” e verifica che la casella “Abilitata” sia selezionata:

![Attivazione](/_astro/win10-srv-6.BgO8lYz7_LBtTp.webp)

* Nella scheda “Azioni” fai clic su “Nuovo…”. Assicurati che sia selezionato “Avvio programma”, poi cerca l’eseguibile `evcc.exe` con “Sfoglia”. È consigliabile impostare il percorso anche nella casella “Inizio”, così il file di configurazione viene trovato automaticamente:

![Azioni](/_astro/win10-srv-7.Cg2QVdnZ_VTO1.webp)

* Nella scheda “Condizioni” puoi lasciare le impostazioni predefinite.

  > **Nota**
  >
  > SMA Home Manager a volte può dare problemi se usato con il Wi-Fi: prova ad attivare la condizione “Rete” e a selezionare l’interfaccia di connessione adatta nel menu a tendina.

![Condizioni](/_astro/win10-srv-8.Cq78wnDy_v434y.webp)

* Nella scheda “Impostazioni” assicurati di selezionare “Esegui l’attività appena possibile dopo un avvio pianificato non eseguito”. Assicurati inoltre che “Arresta l’attività se viene eseguita per più di:” **non** sia selezionato, altrimenti evcc smetterà di funzionare in momenti casuali.

![Impostazioni](/_astro/win10-srv-9.BE4tMRSZ_2cT7c1.webp)

Ora puoi avviare l’attività manualmente o provarla con un riavvio. Per verificare che funzioni, apri `http://localhost:7070` nel browser.

### NSSM

> **Nota**
>
> Questa guida presuppone che evcc si trovi in `c:\Tools\evcc`.
>
> Queste istruzioni si riferiscono a Windows 11.

In alternativa all’Utilità di pianificazione puoi eseguire evcc come servizio Windows. Un servizio funziona senza che un utente abbia effettuato l’accesso e offre un controllo migliore sul riavvio e sulla gestione degli errori.

Poiché evcc non supporta nativamente l’interfaccia dei servizi Windows, puoi usare [*nssm*](https://nssm.cc/download) (*Non-Sucking Service Manager*) come wrapper di servizio.

* Scarica *nssm* da [nssm.cc](https://nssm.cc/download) ed estrai il file ZIP in `C:\Tools\nssm\`.

* Apri un prompt dei comandi (`cmd.exe`) e passa alla cartella `win64`:

  ```sh
  cd /D C:\Tools\nssm\nssm-2.24\win64
  ```

* Installa il servizio:

  ```sh
  nssm install evcc
  ```

* Scorri le schede della finestra di dialogo. Le impostazioni seguenti sono quelle consigliate.

  * **Application**:

    ![Application](/_astro/win11-nssm_01_Application.B5NNs8Ig_Z2vddbC.webp)

    * *Path*: percorso di `evcc.exe`.
    * *Start directory*: directory di lavoro di evcc.
    * *Arguments*: parametri per evcc, ad es. `-c evcc.yaml`. Facoltativo: `--database evcc.db` per impostare esplicitamente il percorso del database. Senza questa opzione il database viene salvato nel profilo utente dell’account che esegue evcc. Con l’account *System* sarebbe `%SystemRoot%\system32\config\systemprofile\.evcc\evcc.db`, cioè una posizione diversa rispetto all’avvio interattivo. Con `--database` ti assicuri che venga usato sempre lo stesso database. Questo è rilevante quando [reimposti la password](/it/faq#password-reset).

  * **Details**:

    ![Details](/_astro/win11-nssm_02_Details.DtC1Cmo2_Z1ORQrT.webp)

    * *Display Name*: nome del servizio nei Servizi di Windows (idealmente uguale a *Service Name*).
    * *Startup type*: *Automatic* per l’avvio automatico all’accensione.

  * **Log on**:

    ![Log on](/_astro/win11-nssm_03_Log_on.BFHa8030_1sHwsA.webp)

    Predefinito: il servizio viene eseguito con l’account *System*. Dettagli: [documentazione di nssm](https://nssm.cc/usage).

    L’account scelto qui determina dove evcc salva il suo database `evcc.db` (vedi *Arguments* sopra).

  * **Dependencies**:

    ![Dependencies](/_astro/win11-nssm_04_Dependencies.BZrv15OJ_Z1rxi6E.webp)

    Aggiungere `NlaSvc` come dipendenza garantisce che la rete sia pronta prima dell’avvio di evcc.

  * **Process**:

    ![Process](/_astro/win11-nssm_05_Process.BGFb9C9K_Z2Cazf.webp)

    Lascia i valori predefiniti.

  * **Shutdown**:

    ![Shutdown](/_astro/win11-nssm_06_Shutdown.o0dl9I5C_2urfKg.webp)

    Lascia i valori predefiniti. nssm prova prima `Ctrl`+`C`, poi `WM_CLOSE`/`WM_QUIT`, e termina forzatamente il processo dopo il timeout.

  * **Exit actions**:

    ![Exit actions](/_astro/win11-nssm_07_Exit_actions.BdjMC2_w_Z2g6OYu.webp)

    Consiglio: *Restart application* con un ritardo di 10 secondi, così evcc si riavvia automaticamente dopo un crash o un riavvio dall’interfaccia web.

  * **I/O**:

    ![I/O](/_astro/win11-nssm_08_IO.CIj1ZSPm_Z24gUn5.webp)

    Facoltativo: reindirizza `stdout` e `stderr` su file di log. Mantieni basso il livello di log di evcc, per evitare che i file crescano troppo in fretta.

  * **File rotation**:

    ![File rotation](/_astro/win11-nssm_09_File_rotation.BcePxhBw_Ztiexw.webp)

    Facoltativo: attiva la rotazione dei log per limitare la dimensione dei file di log.

  * **Environment**:

    ![Environment](/_astro/win11-nssm_10_Environment.-IB738iJ_Z14MXDB.webp)

    Lascia i valori predefiniti.

Fai clic su *Install Service* per installare il servizio. Il servizio si può poi avviare e arrestare dalla console di gestione dei Servizi di Windows. Per verificare, apri `http://localhost:7070` nel browser.