https://github.com/SadarSSI/WSL-WatchDog

Monitor wsl2 : start or restart wsl distribution automatically, update or create firewall rules & proxy, create task...
https://github.com/SadarSSI/WSL-WatchDog

powershell watchdog windows wsl2 wsl2-forwarding-port

Last synced: 16 days ago
JSON representation

Monitor wsl2 : start or restart wsl distribution automatically, update or create firewall rules & proxy, create task...

• Host: GitHub
• URL: https://github.com/SadarSSI/WSL-WatchDog
• Owner: SadarSSI
• Created: 2022-04-08T15:16:32.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2023-02-08T13:38:38.000Z (almost 2 years ago)
• Last Synced: 2024-12-07T23:27:38.205Z (26 days ago)
• Topics: powershell, watchdog, windows, wsl2, wsl2-forwarding-port
• Language: PowerShell
• Homepage:
• Size: 26.4 KB
• Stars: 9
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# WSL-WatchDog

monitor wsl: start or restart wsl automatically, update or create firewall rules & proxy, create scheduled task...

## Why ?

the latest version of wsl stops if you are not connected to the console, or if there is not a job / process a foreground (it can be just a loop in a shell for example)

### My need :

- have a linux wsl running in the background

- that wsl can be launched when windows is launched

- a scheduled task check every xx minutes that wsl run

- create / recreate the firewall rules

- create / recreate portproxy v4tov4 rules

- change the @IP address of the vEthernet card (WSL) and disable the @IP V6 if necessary

- store wsl, scheduled task, firewell rules, etc settings in yaml file

### What should you do in the linux distribution ? 

Create a start.sh file, you can change the name (see in the yaml file in WSLCommon/StartWSL), in which you will have to launch a process or create an infinite loop for WSL to remain active.

### What wsl_watchdog.ps1 does ?

- An elevation of privilege (admin) if necessary like "run as administrator"

reads wsl_params.yml

- load wsl_params.yml

- check if the wsl distribution is active (see Distro in wsl_params.yml)

- check Firewall rules (see Ports in wsl_params.yml)

- check Forwardings rules (see ProxyV4 in wsl_params.yml)

### What do you need to ro create wsl_watchdog sheduled task : ?

Install [Powershell-Yaml](https://github.com/cloudbase/powershell-yaml)

* In PowerShell as Administrator

    `Install-Module powershell-yaml`

Edit wsl_params.yml for the WSL distro to use and the location of WSL-Watchdog scripts. `wsl --list` shows installed distros.

Call wsl_create_task.ps1. This script read thle yaml file wsl_params.yml, create wsl_watchdog task with 2 triggers :

- atstartup : to start wsl_watchdog.ps1 script

- daily : start wsl_watchdog.ps1 script evry 5mn (see TaskDuration in wsl_params.yml)