Skip to content
This repository has been archived by the owner on Mar 6, 2024. It is now read-only.
/ winthainer Public archive

๐Ÿ‹ Container engine in WSL. Controlled in Windows

License

Notifications You must be signed in to change notification settings

chirpcel/winthainer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

51 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Winthainer

๐Ÿ“ Description

Winthainer is a little toolset which uses the wsl to provide container functionality on Windows.

There are literally three components:

  • WinthainerDistribution

    • Alpine based wsl distribution with installed docker engine

  • WinthainerService

    • Tray application which launches dockerd inside WinthainerDistribution

  • WinthainerCommand

    • CLI tool to "proxy" commands to docker cli inside WinthainerDistribution

๐Ÿ“ฆ๏ธ Installation

Requirements:

  • Windows >= 10

  • WSL v2 with the latest kernel

    • hint: run wsl --update inside PowerShell

Installation steps:

  • Dowload latest Winthainer Release

  • Extract WinthainerDeployment.zip

  • Run WinthainerInstaller.exe

๐Ÿš€ Usage

Start service

To use Winthainer you have to start the WinthainerService. It manages the container runtime daemon inside wsl.

WinthainerService.exe

Test functionality

WinthainerCommand.exe run hello-world

After that, you should see the output of the hello-world container.

Local paths

Commands like

WinthainerCommand.exe run -it -v C:\Mount:/mnt ubuntu /bin/bash

or

WintainerCommand.exe run -dit -p 8080:80 -v ${PWD}:/usr/local/apache2/htdocs/ httpd:2.4

will work.

WinthainerCommand translates Windows paths to the equivalent WSL path. The used path have to be mounted inside wsl. Auto mount is active by default in wsl, so it should work. Otherwise, you have to mount it manually.

You can now use WinthainerCommand like Docker/Podman CLI

About

๐Ÿ‹ Container engine in WSL. Controlled in Windows

Resources

License

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages