Skip to content
Webkom Docs

WSL Oppsett

WSL (Windows Subsystem for Linux) gir deg et komplett Linux-miljø på Windows, som er ideelt for webutvikling. Denne guiden hjelper deg med å sette opp WSL for echo Webkom utvikling.

Hvorfor WSL?

Section titled “Hvorfor WSL?”
  • Konsistent miljø: Samme kommandoer som macOS og Linux
  • Bedre ytelse: Raskere filoperasjoner for Node.js prosjekter
  • Native verktøy: Tilgang til Linux-verktøy og package managers
  • Docker support: Enklere Docker-integrasjon

1. Aktiver WSL

Section titled “1. Aktiver WSL”

WSL 2 (Anbefalt)

Section titled “WSL 2 (Anbefalt)”

Åpne PowerShell som administrator og kjør:

Terminal window
# Aktiver WSL feature
wsl --install

Restart datamaskinen etter at du har aktivert WSL.

Sett WSL 2 som standard

Section titled “Sett WSL 2 som standard”
Terminal window
wsl --set-default-version 2

2. Installer Ubuntu

Section titled “2. Installer Ubuntu”

Fra Microsoft Store

Section titled “Fra Microsoft Store”
  1. Åpne Microsoft Store
  2. Søk etter “Ubuntu” eller “Ubuntu 22.04 LTS”
  3. Installer den nyeste LTS-versjonen

Fra kommandolinje

Section titled “Fra kommandolinje”
Terminal window
# List tilgjengelige distribusjoner
wsl --list --online


# Installer Ubuntu
wsl --install -d Ubuntu-22.04

3. Første gangs oppsett

Section titled “3. Første gangs oppsett”

Opprett bruker

Section titled “Opprett bruker”

Første gang du starter Ubuntu vil du bli bedt om å:

  1. Opprette et brukernavn (bruk samme som Windows-bruker for enkelhets skyld)
  2. Sette et passord (kan være forskjellig fra Windows-passordet)

Oppdater systemet

Section titled “Oppdater systemet”
Terminal window
sudo apt update && sudo apt upgrade -y

4. Installer essensielle verktøy

Section titled “4. Installer essensielle verktøy”

Node.js og pnpm

Section titled “Node.js og pnpm”
Terminal window
# Installer Fast Node Manager
curl -fsSL https://fnm.vercel.app/install | bash


# Restart terminal eller kjør:
source ~/.bashrc


# Installer latest Node.js LTS
fnm use 22


# Installer pnpm
npm install -g pnpm

Git

Section titled “Git”
Terminal window
sudo apt install git

Docker (valgfritt)

Section titled “Docker (valgfritt)”
Terminal window
# Installer Docker Engine
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh


# Legg til bruker i docker gruppen
sudo usermod -aG docker $USER


# Start Docker service
sudo service docker start

5. Konfigurer utviklingsmiljø

Section titled “5. Konfigurer utviklingsmiljø”

Sett opp Git (se Git guide for detaljer)

Section titled “Sett opp Git (se Git guide for detaljer)”
Terminal window
git config --global user.name "Ditt Navn"
git config --global user.email "din.epost@student.uib.no"

Installer cenv for echo utvikling

Section titled “Installer cenv for echo utvikling”
Terminal window
# Installer cenv
curl -sSL https://raw.githubusercontent.com/echo-webkom/cenv/main/install.sh | bash


source ~/.bashrc


# Verifiser installasjon
cenv --version

Om det ikke funker legg til ~/.local/bin i din PATH.

6. VSCode integrasjon

Section titled “6. VSCode integrasjon”

Installer WSL extension

Section titled “Installer WSL extension”
  1. Åpne VSCode på Windows
  2. Installer “WSL” extension (ms-vscode-remote.remote-wsl)
  3. Restart VSCode

Åpne prosjekt i WSL

Section titled “Åpne prosjekt i WSL”
Terminal window
# Fra WSL terminal, naviger til prosjektmappen
git clone git@github.com:echo-webkom/echo-web-mono.git
cd echo-web-mono


# Åpne i VSCode
code .

VSCode vil automatisk koble til WSL og installere nødvendige extensions.

7. Filsystem og ytelse

Section titled “7. Filsystem og ytelse”

Hvor skal prosjekter ligge?

Section titled “Hvor skal prosjekter ligge?”
  • Anbefalt: /home/username/projects/ (WSL filsystem)
  • Unngå: /mnt/c/Users/... (Windows filsystem - langsommere)

8. Nyttige WSL kommandoer

Section titled “8. Nyttige WSL kommandoer”
Terminal window
# Fra Windows PowerShell/CMD


# List alle WSL distribusjoner
wsl --list --verbose


# Start spesifikk distribusjon
wsl -d Ubuntu-22.04


# Stopp WSL
wsl --shutdown


# Åpne filutforsker i WSL
wsl explorer.exe .


# Kjør Linux kommando fra Windows
wsl ls -la

9. Terminal setup

Section titled “9. Terminal setup”

Installer Windows Terminal (anbefalt)

Section titled “Installer Windows Terminal (anbefalt)”
Terminal window
# Fra Microsoft Store eller:
winget install Microsoft.WindowsTerminal

10. Feilsøking

Section titled “10. Feilsøking”

WSL tar lang tid å starte

Section titled “WSL tar lang tid å starte”
Terminal window
# Restart WSL service
wsl --shutdown
wsl

Tilkoblingsproblemer med VSCode

Section titled “Tilkoblingsproblemer med VSCode”
  1. Sjekk at WSL extension er installert
  2. Restart både VSCode og WSL
  3. Prøv å koble til manuelt: Ctrl+Shift+P → “WSL: Connect to WSL”

11. Best Practices

Section titled “11. Best Practices”

Filstruktur

Section titled “Filstruktur”
Windows: C:\Users\YourName\
WSL:     /home/username/
         ├── projects/           # Alle development prosjekter
         │   ├── echo-web-mono/
         │   └── andre-prosjekter/
         └── .ssh/              # SSH nøkler

SSH nøkler

Section titled “SSH nøkler”
  • Opprett SSH nøkler i WSL (ssh-keygen)
  • Ikke kopier fra Windows til WSL
  • Hver WSL distribusjon bør ha sine egne nøkler

Environment variables

Section titled “Environment variables”
Terminal window
# Legg til i ~/.bashrc eller ~/.zshrc
export EDITOR="code --wait"
export BROWSER="wslview"


# echo-spesifikke environment variables
export NODE_ENV="development"

12. Integrasjon med Windows

Section titled “12. Integrasjon med Windows”

Åpne Windows Explorer fra WSL

Section titled “Åpne Windows Explorer fra WSL”
Terminal window
# Åpne current directory i Windows Explorer
explorer.exe .


# Åpne spesifikk mappe
explorer.exe /home/username/projects

Kopiere mellom WSL og Windows

Section titled “Kopiere mellom WSL og Windows”
Terminal window
# Kopier til Windows clipboard
cat file.txt | clip.exe


# Fra Windows til WSL (lim inn i terminal)
# Høyreklikk i terminal

Neste steg

Section titled “Neste steg”