> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 0. WSL 2:n ja Docker Desktopin asennus

> Asenna WSL 2 ja Ubuntu ja yhdistä sitten Ubuntu Docker Desktopiin Windowsissa.

Ayakaleaf Pro käyttää Linux-kontteja. Asenna Windowsissa Docker Desktop sen WSL 2 -taustajärjestelmän kanssa ja aja Toolkitin skriptit Ubuntussa.

WSL 2 tarjoaa Linux-ytimen. Docker Desktop hallinnoi Docker-moottoria omassa `docker-desktop`-ympäristössään; **WSL Integration** -asetuksen käyttöönotto antaa Ubuntun Docker CLI:n kommunikoida kyseisen moottorin kanssa. Toolkit käynnistää sitten sovelluksen, MongoDB:n ja Redisin kontteina. Kun hiekkalaatikkokäännökset ovat käytössä, sovellus käyttää moottorin Docker-socketia erillisen TeX Live -kontin käynnistämiseen jokaista käännöstä varten. Et tarvitse MongoDB:n, Redisin tai TeX Liven Windows-asennuksia.

**1. Asenna WSL 2 ja Ubuntu**

Avaa Windowsissa **PowerShell järjestelmänvalvojana** ja suorita:

```powershell theme={null}
wsl --install -d Ubuntu
```

Käynnistä Windows uudelleen, jos sitä pyydetään. Avaa **Ubuntu** Käynnistä-valikosta ja luo Linux-käyttäjänimi ja -salasana. Tämä on Ubuntun `sudo`-tili; se on erillinen Windows-kirjautumisestasi.

Päivitä WSL ja tarkista jakelu takaisin **PowerShellissä**:

```powershell theme={null}
wsl --update
wsl --version
wsl --list --verbose
```

Ubuntu-rivillä on näyttävä **VERSION 2**. Jos siinä näkyy 1, käytä luettelossa näkyvää jakelun tarkkaa nimeä:

```powershell theme={null}
wsl --set-version Ubuntu 2
```

Docker vaatii WSL:n version **2.1.5 tai uudemman**; komennon `wsl --version` näyttämä WSL-ohjelmiston versio ja jakelun **VERSION 2** -sarake ovat eri tarkistuksia. Jos asennus epäonnistuu, katso [asennuksen vianmääritys](https://ayakaleaf-pro.mintlify.site/fi/on-premises/installation/using-docker-compose/windows/troubleshooting.md#wsl-or-docker-reports-that-virtualization-is-unavailable) ja [Microsoftin asennusohjeet](https://learn.microsoft.com/en-us/windows/wsl/install), ja ota laitteistovirtualisointi käyttöön BIOS/UEFI-asetuksissa, jos WSL ilmoittaa, ettei se ole käytettävissä.

**2. Asenna ja käynnistä Docker Desktop**

Lataa suorittimellesi sopiva [Docker Desktop for Windows](https://docs.docker.com/desktop/setup/install/windows-install/) ja suorita asennusohjelma. Käytä **WSL 2** -taustajärjestelmää, jos sitä tarjotaan. Avaa **Docker Desktop** Windowsin Käynnistä-valikosta ja odota, että moottori käynnistyy.

Ota Docker Desktopin kohdassa **Settings → General** käyttöön **Use WSL 2 based engine**, jos vaihtoehto näkyy. Ota kohdassa **Settings → Resources → WSL Integration** integraatio käyttöön **Ubuntulle** ja valitse sitten **Apply** tai **Apply & restart**. Jos Ubuntu ei ole oletusjakelusi, ota sen oma kytkin käyttöön erikseen.

Jos WSL Integration puuttuu, tarkista, että Docker Desktop käyttää **Linux-kontteja**. Katso [Dockerin WSL 2 -taustajärjestelmän opas](https://docs.docker.com/desktop/features/wsl/).

Käytä tässä oppaassa Docker Desktopin integraatiota. Toisen Docker Enginen asentaminen komennolla `apt install docker.io` tai `dockerd`:n käynnistäminen Ubuntussa luo erillisen kokoonpanon ja voi aiheuttaa ristiriitoja. Jos käytät jo Engineä Ubuntussa, noudata Dockerin siirto-ohjeita ennen vaihtamista; säilytä olemassa oleva sovellusdata ja varmuuskopiot.

**3. Tarkista Docker Ubuntusta**

Avaa **Ubuntu**-pääte. Suorita siellä nämä komennot ilman `sudo`a:

```bash theme={null}
docker version
docker compose version
docker ps
```

Komennon `docker version` on näytettävä sekä **Client** että **Server**. Tyhjä konttiluettelo on normaali uudessa asennuksessa. Pelkkä `docker --version` ei todista, että moottori on käynnissä.

Jos `docker` ei ole käytettävissä tai ei saa yhteyttä, avaa Ubuntu uudelleen WSL Integrationin käyttöönoton jälkeen ja tarkista, että Docker Desktop on käynnissä. Katso [Vianmääritys](https://ayakaleaf-pro.mintlify.site/fi/on-premises/installation/using-docker-compose/windows/troubleshooting.md#docker-is-unavailable-in-ubuntu).

**4. Tarkista resurssit ja Docker-socket**

Tarkista Dockerin näkemät resurssit:

```bash theme={null}
docker info --format 'CPUs={{.NCPU}} Memory={{.MemTotal}} Kernel={{.KernelVersion}}'
df -h "$HOME"
ls -l /var/run/docker.sock
```

Pientä paikallista instanssia varten Dockerin käytettävissä olevat 4 suoritinta ja 8 Gt muistia ovat suositeltu lähtökohta, eivät mitattu vähimmäisvaatimus. Jätä riittävästi muistia myös Windowsille. WSL 2 -taustajärjestelmää käytettäessä resurssirajoja hallitaan [WSL-asetusten](https://learn.microsoft.com/en-us/windows/wsl/wsl-config) kautta eikä Macin Docker Desktopin resurssiliukusäätimillä. Muutokset, jotka vaativat komennon `wsl --shutdown`, keskeyttävät kaikki käynnissä olevat WSL-jakelut ja Docker-kuormat; tee ne ennen instanssin käynnistämistä.

Jätä `DOCKER_SOCKET_PATH=/var/run/docker.sock` Toolkitin määrityksiin. Sovellus tarvitsee tämän moottorin socketin hiekkalaatikkokäännöksiä varten. Älä muuta sen käyttöoikeuksia arvoon `777` yhteysvirheiden korjaamiseksi; palauta sen sijaan Docker Desktopin integraatio.

### Seuraava vaihe

Kun `docker ps` toimii Ubuntussa, jatka vaiheeseen [1. Lataa Toolkit](https://ayakaleaf-pro.mintlify.site/fi/on-premises/installation/using-docker-compose/windows/1.-download-the-toolkit.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.