This project aims to be a frictionless Docker distribution for Windows.
Stevedore can be used as a replacement for DockerMsftProvider
, Docker Desktop or Mirantis Container Runtime.
Windows Containers are fully supported.
Linux Containers support is in experimental mode.
-
Windows 10, 11
-
Windows Server 2016, 2019, 2022 (no Linux containers due to lack of WSL2)
Stevedore is available via Chocolatey package manager. If you already have Chocolatey installed, you can just run the following command from elevated console:
choco install stevedore
Note that reboot is required before you can use docker
commands.
Planned, but not available yet.
-
Download MSI installer
-
Double-click on it
-
Next-next-next
-
Reboot your computer. This is needed to finish installation of Windows Containers feature and to add your user to
docker-users
group so user can access Docker service. -
Profit!
docker
command is now available on your PATH anddockerd
service is already running.
Stevedore installer supports several command-line options that may be handy to configure unattended installations.
Basic usage: msiexec /i c:\path\to\stevedore.msi
.
For quiet (non-interactive) installation add /quiet
option.
If you only want to install specific Stevedore features, use /ADDLOCAL=Feature1,Feature2,Feature3
syntax.
/ADDLOCAL
-
FeatureWindowsContainers
installs Windows Containers support, including Stevedore service. It allows running containers with process isolation. -
FeatureHyperV
installs Hyper-V support. It allows running containers with Hyper-V isolation. -
FeatureLinuxContainers
installs Linux Containers support.
You can also pass custom installation properties to Stevedore installer using /PROPERTY=value
syntax.
-
/INSTALLDIR=%ProgramFiles%\Stevedore
specifies directory where Stevedore executable files will be installed -
/SERVICENAME=stevedore
specifies Windows service name
When installing Stevedore via Chocolatey, use this syntax: choco install stevedore --install-arguments="/ADDLOCAL=Feature1,Feature2,Feature3 /PROPERTY=value /quiet"
-
Docker Engine 20.10.12
-
Docker App 0.9.1-beta3
-
Buildx 0.7.1
-
Docker Compose 2.2.3
-
Docker Scan 0.17.0
After installation and reboot, docker
command should be available on PATH and ready to use.
Just try docker run hello-world
from a command line.
In order to communicate with Docker engine, users needs to be in docker-users
group.
Upon installation, Stevedore automatically adds installing user to docker-users
.
If you need other users to also access Docker engine, you will need to add them manually.
You can use Add-LocalGroupMember PowerShell commandlet for that.
Stevedore stores configuration and runtime data files under %ProgramData%\Docker
directory.
In order to try Linux Containers support, you first need to enable "Linux Containers (Experimental)" feature in Stevedore installer.
Warning
|
Do NOT enable Windows and Linux Containers simultaneously. Currently, both of them bind to the same Windows named pipe, so they would conflict when run at the same time. |
After installing Stevedore, you need to reboot and install Linux kernel update package for WSL2.
Finally, run Stevedore app using desktop shortcut or start menu.
If everything was done properly, you’ll be able to use docker
command to work with Linux containers.
See it in action:
Desktop_220214_1355.mp4
-
Install WiX Toolset either manually or by running
choco install wixtoolset
if you have Chocolatey -
Clone Stevedore Git repository
-
Run
cargo install cargo-wix
to install cargo-wix -
Run
cargo wix --nocapture
in repository root. Ready-to-use MSI package will be built in<repo>/target/wix
directory.