# Windows

> Installez evcc manuellement sous Windows, lancez-le depuis l’invite de commandes ou comme service en arrière-plan, puis mettez-le à jour ou rétrogradez-le.

Vous trouverez ici les instructions pour installer evcc manuellement sous Windows.

> **Attention**
>
> Cette installation manuelle demande des connaissances avancées en informatique, en particulier pour travailler avec l’invite de commandes ou PowerShell.
>
> Il est possible d’exécuter evcc sous Windows. evcc est toutefois généralement utilisé dans un environnement Linux (p. ex. Raspberry Pi).

## Installation

1. ### Installer

   Téléchargez le fichier adapté à votre système et décompressez-le (p. ex. en double-cliquant dessus) :

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

   Ouvrez l’invite de commandes et placez-vous dans le dossier décompressé. Vérifiez l’installation :

   ```sh
   evcc -v
   ```

   La version actuelle d’evcc doit s’afficher (p. ex. `evcc version 0.xxx.y`).

2. ### Démarrer

   ```sh
   ./evcc
   ```

3. ### Configurer

   Ouvrez l’interface web d’evcc dans votre navigateur : <http://localhost:7070>. Définissez un mot de passe administrateur et configurez vos appareils directement dans l’interface web.

## Fichier de configuration (alternative)

Au lieu de l’interface web, vous pouvez utiliser un fichier de configuration `evcc.yaml`. Vous trouverez les détails à la page [Configuration](/fr/installation/configuration).

Démarrez evcc avec :

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

## Mise à jour et retour à une version antérieure

Suivez les étapes ci-dessus et remplacez le fichier du programme evcc par la nouvelle version ou la version précédente. Il n’est pas nécessaire de refaire la configuration.

## Service en arrière-plan

### Planificateur de tâches

> **Note**
>
> Cette documentation part du principe qu’evcc se trouve dans `c:\evcc`.
>
> Ces instructions ont été rédigées sous Windows 10.

* Ouvrez le menu Démarrer et recherchez « Planificateur de tâches », puis faites un clic droit dessus et choisissez « Exécuter en tant qu’administrateur » :

![Planificateur de tâches de Windows 10](/_astro/win10-srv-1.BQfo4Mab_Z1atspj.webp)

* Une fois le Planificateur de tâches lancé, choisissez si la nouvelle tâche doit être créée dans un dossier dédié ou directement dans la Bibliothèque du Planificateur de tâches. Dans cet exemple, nous créons un dossier `evcc` dédié. Sélectionnez « Bibliothèque du Planificateur de tâches », ouvrez le menu contextuel par un clic droit et choisissez « Nouveau dossier… » :

![Bibliothèque du Planificateur de tâches](/_astro/win10-srv-2.BvLQnUHf_1Pz5ad.webp)

* Sélectionnez maintenant le nouveau dossier `evcc` et ouvrez à nouveau le menu contextuel. Choisissez « Créer une tâche » :

![Fenêtre Nouvelle tâche](/_astro/win10-srv-3.Bem2aFTu_1pt2Xc.webp)

* Donnez un nom à la tâche (p. ex. « evcc ») et une courte description. Comme la tâche doit s’exécuter en tant que service système, ouvrez la gestion des utilisateurs via « Changer d’utilisateur ou de groupe… » et saisissez `SYSTEM` dans le champ. Cliquez sur « Vérifier les noms » : le mot « SYSTEM » doit alors être souligné. Cliquez sur « OK » pour fermer la boîte de dialogue :

![Fenêtre de la tâche](/_astro/win10-srv-4.ZgX5SuZj_Z1mM5I1.webp) ![Sélection de l’utilisateur](/_astro/win10-srv-5.CBq4gGTQ_Z1G9HJx.webp)

* Dans l’onglet « Déclencheurs », cliquez sur « Nouveau… ». Réglez le déclencheur sur « Au démarrage » et vérifiez que la case « Activée » est cochée :

![Déclencheur](/_astro/win10-srv-6.BgO8lYz7_LBtTp.webp)

* Dans l’onglet « Actions », cliquez sur « Nouveau… ». Vérifiez que « Démarrer un programme » est sélectionné, puis recherchez l’exécutable `evcc.exe` avec le bouton « Parcourir… ». Il est recommandé d’indiquer aussi le chemin dans le champ « Commencer dans » afin que le fichier de configuration soit trouvé automatiquement :

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

* Dans l’onglet « Conditions », les paramètres par défaut peuvent être conservés.

  > **Note**
  >
  > Le SMA Home Manager peut parfois poser problème en Wi-Fi ; essayez d’activer la condition « Réseau » et de sélectionner l’interface de connexion appropriée dans la liste déroulante.

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

* Dans l’onglet « Paramètres », veillez à sélectionner « Exécuter la tâche dès que possible si un démarrage planifié est manqué ». Vérifiez aussi que l’option « Arrêter la tâche si elle s’exécute plus de : » n’est **pas** cochée, sinon evcc s’arrêtera de manière aléatoire.

![Paramètres](/_astro/win10-srv-9.BE4tMRSZ_2cT7c1.webp)

Vous pouvez maintenant démarrer la tâche manuellement ou la tester en redémarrant l’ordinateur. Pour vérifier qu’elle fonctionne, ouvrez `http://localhost:7070` dans votre navigateur.

### NSSM

> **Note**
>
> Cette documentation part du principe qu’evcc se trouve dans `c:\Tools\evcc`.
>
> Ces instructions ont été rédigées sous Windows 11.

Au lieu du Planificateur de tâches, vous pouvez exécuter evcc comme service Windows. Un service s’exécute sans ouverture de session et offre un meilleur contrôle du redémarrage et de la gestion des erreurs.

Comme evcc ne prend pas en charge nativement l’interface de service de Windows, vous pouvez utiliser [*nssm*](https://nssm.cc/download) (*Non-Sucking Service Manager*) pour faire tourner evcc en tant que service.

* Téléchargez *nssm* depuis [nssm.cc](https://nssm.cc/download) et décompressez le fichier ZIP dans `C:\Tools\nssm\`.

* Ouvrez une invite de commandes (`cmd.exe`) et placez-vous dans le dossier `win64` :

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

* Installez le service :

  ```sh
  nssm install evcc
  ```

* Parcourez les onglets de la boîte de dialogue. Les paramètres suivants sont des recommandations.

  * **Application** :

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

    * *Path* : chemin vers `evcc.exe`.
    * *Start directory* : répertoire de travail d’evcc.
    * *Arguments* : arguments de ligne de commande pour evcc, p. ex. `-c evcc.yaml`. Facultatif : `--database evcc.db` pour définir explicitement le chemin de la base de données. Sans cette option, la base de données est enregistrée dans le profil utilisateur du compte qui exécute evcc. Sous le compte *System*, il s’agit de `%SystemRoot%\system32\config\systemprofile\.evcc\evcc.db`, soit un autre emplacement que lors d’un démarrage interactif. Avec `--database`, vous vous assurez que la même base de données est toujours utilisée. Cela a son importance lors de la [réinitialisation du mot de passe](/fr/faq#password-reset).

  * **Details** :

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

    * *Display Name* : nom du service dans les services Windows (idéalement identique à *Service Name*).
    * *Startup type* : *Automatic* pour un démarrage automatique au lancement de Windows.

  * **Log on** :

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

    Par défaut, le service s’exécute sous le compte *System*. Pour plus de détails, consultez la [documentation de nssm](https://nssm.cc/usage).

    Le compte choisi ici détermine l’emplacement où evcc enregistre sa base de données `evcc.db` (voir *Arguments* ci-dessus).

  * **Dependencies** :

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

    Ajouter `NlaSvc` comme dépendance garantit que le réseau est prêt avant le démarrage d’evcc.

  * **Process** :

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

    Conservez les valeurs par défaut.

  * **Shutdown** :

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

    Conservez les valeurs par défaut. nssm essaie d’abord `Ctrl`+`C`, puis `WM_CLOSE`/`WM_QUIT`, et force l’arrêt du processus une fois le délai écoulé.

  * **Exit actions** :

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

    Recommandation : *Restart application* avec un délai de 10 secondes, afin qu’evcc redémarre automatiquement après un plantage ou un redémarrage depuis l’interface web.

  * **I/O** :

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

    Facultatif : redirigez `stdout` et `stderr` vers des fichiers journaux. Gardez un niveau de journalisation bas dans evcc pour éviter que les fichiers grossissent trop vite.

  * **File rotation** :

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

    Facultatif : activez la rotation des journaux pour limiter la taille des fichiers journaux.

  * **Environment** :

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

    Conservez les valeurs par défaut.

Cliquez sur *Install Service* pour créer le service. Le service peut ensuite être démarré et arrêté depuis la console de gestion des services Windows. Pour vérifier, ouvrez `http://localhost:7070` dans votre navigateur.