# Windows

> Installeer evcc handmatig op Windows, start het via de opdrachtprompt of als achtergrondservice en voer later een update of downgrade uit.

Hier vindt u instructies voor het handmatig installeren van evcc op Windows.

> **Opgepast**
>
> Deze handmatige installatie vereist gevorderde pc-kennis, vooral bij het werken met de opdrachtprompt of PowerShell.
>
> evcc op Windows draaien is mogelijk. evcc wordt echter meestal in een Linux-omgeving gebruikt (bijv. Raspberry Pi).

## Installatie

1. ### Installeren

   Download het juiste bestand voor uw systeem en pak het uit (bijv. door erop te dubbelklikken):

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

   Open de opdrachtprompt en ga naar de uitgepakte map. Controleer de installatie:

   ```sh
   evcc -v
   ```

   U zou nu de huidige versie van evcc moeten zien (bijv. `evcc version 0.xxx.y`).

2. ### Start

   ```sh
   ./evcc
   ```

3. ### Instellen

   Open de evcc-interface in uw browser: <http://localhost:7070>. Stel een beheerderswachtwoord in en configureer uw apparaten direct via de webinterface.

## Configuratiebestand (alternatief)

Als alternatief voor de webinterface kunt u een configuratiebestand `evcc.yaml` gebruiken. Zie [Configuratie](/nl/installation/configuration) voor details.

Start evcc met:

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

## Updaten en downgraden

Volg de stappen hierboven en vervang het evcc-programmabestand door de nieuwe of vorige versie. De configuratie hoeft niet opnieuw te worden ingesteld.

## Achtergrondservice

### Taakplanner

> **Opmerking**
>
> Deze documentatie gaat ervan uit dat evcc in `c:\evcc` staat.
>
> Deze instructies zijn gemaakt met Windows 10.

* Open het startmenu en zoek naar “Taakplanner”, klik er met de rechtermuisknop op en kies “Als administrator uitvoeren”:

![Windows 10 Taakplanner](/_astro/win10-srv-1.BQfo4Mab_Z1atspj.webp)

* Kies na het starten van de Taakplanner of u de nieuwe taak in een eigen map of in de algemene Bibliotheek Taakplanner wilt aanmaken. In dit voorbeeld maken we een aparte map `evcc` aan. Selecteer “Bibliotheek Taakplanner”, open met de rechtermuisknop het contextmenu en kies “Nieuwe map…”:

![Bibliotheek Taakplanner](/_astro/win10-srv-2.BvLQnUHf_1Pz5ad.webp)

* Selecteer nu de nieuwe map `evcc` en open opnieuw het contextmenu. Kies “Taak maken”:

![Venster Nieuwe taak](/_astro/win10-srv-3.Bem2aFTu_1pt2Xc.webp)

* Geef de taak een naam (bijv. “evcc”) en een korte beschrijving. Omdat de taak als systeemservice moet draaien, opent u via “Gebruiker of groep wijzigen” het venster om een gebruiker te selecteren en voert u `SYSTEM` in het invoerveld in. Klik op “Namen controleren”, waarna het woord “SYSTEM” onderstreept moet zijn. Klik op OK om het venster te sluiten:

![Taakvenster](/_astro/win10-srv-4.ZgX5SuZj_Z1mM5I1.webp) ![Gebruikersselectie](/_astro/win10-srv-5.CBq4gGTQ_Z1G9HJx.webp)

* Klik op het tabblad “Triggers” op “Nieuw…”. Stel de trigger in op “Bij opstarten” en controleer of het selectievakje “Ingeschakeld” is aangevinkt:

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

* Klik op het tabblad “Acties” op “Nieuw…”. Zorg dat “Een programma starten” is geselecteerd en zoek dan via “Bladeren” het programmabestand `evcc.exe`. Het is aan te raden ook het pad in het veld “Beginnen in” in te vullen, zodat het configuratiebestand automatisch wordt gevonden:

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

* Op het tabblad “Voorwaarden” kunnen de standaardinstellingen ongewijzigd blijven.

  > **Opmerking**
  >
  > De SMA Home Manager kan soms problemen geven in combinatie met wifi. Probeer in dat geval de voorwaarde “Netwerk” in te schakelen en de juiste netwerkverbinding in de keuzelijst te kiezen.

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

* Selecteer op het tabblad “Instellingen” de optie “Taak zo snel mogelijk uitvoeren nadat een geplande start is gemist”. Zorg er ook voor dat “Taak stoppen als deze langer wordt uitgevoerd dan:” **niet** is geselecteerd, anders wordt evcc na verloop van tijd onverwacht gestopt.

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

De taak kan nu handmatig worden gestart of met een herstart worden getest. Ga ter controle in uw browser naar `http://localhost:7070`.

### NSSM

> **Opmerking**
>
> Deze documentatie gaat ervan uit dat evcc in `c:\Tools\evcc` staat.
>
> Deze instructies zijn gemaakt met Windows 11.

Als alternatief voor de Taakplanner kunt u evcc als Windows-service draaien. Een service draait zonder dat een gebruiker is ingelogd en biedt betere controle over het herstartgedrag en de foutafhandeling.

Omdat evcc de Windows-serviceinterface niet zelf ondersteunt, kan [*nssm*](https://nssm.cc/download) (*Non-Sucking Service Manager*) als servicewrapper worden gebruikt.

* Download *nssm* van [nssm.cc](https://nssm.cc/download) en pak het ZIP-bestand uit naar `C:\Tools\nssm\`.

* Open een opdrachtprompt (`cmd.exe`) en ga naar de map `win64`:

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

* Installeer de service:

  ```sh
  nssm install evcc
  ```

* Loop de tabbladen van het venster door. De volgende instellingen zijn aanbevelingen.

  * **Application**:

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

    * *Path*: pad naar `evcc.exe`.
    * *Start directory*: werkmap voor evcc.
    * *Arguments*: parameters voor evcc, bijv. `-c evcc.yaml`. Optioneel: `--database evcc.db` om het databasepad expliciet in te stellen. Zonder deze optie wordt de database opgeslagen in het gebruikersprofiel van het account dat evcc uitvoert. Onder het account *System* is dat `%SystemRoot%\system32\config\systemprofile\.evcc\evcc.db`, een andere locatie dan bij een interactieve start. Met `--database` zorgt u ervoor dat altijd dezelfde database wordt gebruikt. Dit is van belang bij het [opnieuw instellen van het wachtwoord](/nl/faq#password-reset).

  * **Details**:

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

    * *Display Name*: naam van de service in Windows Services (bij voorkeur gelijk aan *Service Name*).
    * *Startup type*: *Automatic* voor automatisch starten bij het opstarten.

  * **Log on**:

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

    Standaard: de service draait onder het account *System*. Details: [nssm-documentatie](https://nssm.cc/usage).

    Het hier gekozen account bepaalt waar evcc zijn database `evcc.db` opslaat (zie *Arguments* hierboven).

  * **Dependencies**:

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

    Door `NlaSvc` als afhankelijkheid toe te voegen, zorgt u ervoor dat het netwerk gereed is voordat evcc start.

  * **Process**:

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

    Standaardinstellingen behouden.

  * **Shutdown**:

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

    Standaardinstellingen behouden. nssm probeert eerst `Ctrl`+`C`, daarna `WM_CLOSE`/`WM_QUIT`, en beëindigt het proces geforceerd na een time-out.

  * **Exit actions**:

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

    Aanbeveling: *Restart application* met een vertraging van 10 seconden, zodat evcc na een crash of een herstart via de webinterface automatisch opnieuw start.

  * **I/O**:

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

    Optioneel: leid `stdout` en `stderr` om naar logbestanden. Houd het logniveau van evcc laag, zodat de bestanden niet te snel groeien.

  * **File rotation**:

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

    Optioneel: schakel logrotatie in om de grootte van de logbestanden te beperken.

  * **Environment**:

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

    Standaardinstellingen behouden.

Klik op *Install Service* om de service te installeren. De service kan daarna via de Windows-beheerconsole Services worden gestart en gestopt. Ga ter controle in uw browser naar `http://localhost:7070`.