{"id":13446682,"url":"https://github.com/slonopotamus/stevedore","last_synced_at":"2025-04-06T05:18:12.319Z","repository":{"id":37542475,"uuid":"380783033","full_name":"slonopotamus/stevedore","owner":"slonopotamus","description":"🚢 Docker distribution for Windows Containers that Just Works","archived":false,"fork":false,"pushed_at":"2024-09-19T08:41:12.000Z","size":334,"stargazers_count":295,"open_issues_count":5,"forks_count":11,"subscribers_count":10,"default_branch":"main","last_synced_at":"2024-10-13T14:11:29.543Z","etag":null,"topics":["containers","docker","windows"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/slonopotamus.png","metadata":{"files":{"readme":"README.adoc","changelog":"CHANGELOG.adoc","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-06-27T16:06:02.000Z","updated_at":"2024-10-10T14:04:03.000Z","dependencies_parsed_at":"2023-12-31T15:21:20.010Z","dependency_job_id":"56085e91-9daf-4d57-b454-8daa94083e3d","html_url":"https://github.com/slonopotamus/stevedore","commit_stats":null,"previous_names":[],"tags_count":47,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slonopotamus%2Fstevedore","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slonopotamus%2Fstevedore/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slonopotamus%2Fstevedore/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slonopotamus%2Fstevedore/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/slonopotamus","download_url":"https://codeload.github.com/slonopotamus/stevedore/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247436362,"owners_count":20938547,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["containers","docker","windows"],"created_at":"2024-07-31T05:00:56.669Z","updated_at":"2025-04-06T05:18:12.299Z","avatar_url":"https://github.com/slonopotamus.png","language":"Rust","funding_links":[],"categories":["Container Operations","User Interfaces","Rust"],"sub_categories":["User Interface","Desktop"],"readme":"= Stevedore\nMarat Radchenko\n:slug: slonopotamus/stevedore\n:uri-project: https://github.com/{slug}\n:uri-ci: {uri-project}/actions?query=branch%3Amain\n\nimage:{uri-project}/actions/workflows/ci.yml/badge.svg?branch=main[Build Status,link={uri-ci}]\nimage:https://img.shields.io/github/release/{slug}.svg[Download,link={uri-project}/releases/latest]\nimage:https://img.shields.io/chocolatey/v/stevedore[Chocolatey package,link=https://community.chocolatey.org/packages/stevedore]\nimage:https://img.shields.io/winget/v/Slonopotamus.Stevedore[WinGet package,link=https://winstall.app/apps/Slonopotamus.Stevedore]\n\n== Overview\n\nThis project aims to provide a frictionless Docker experience for Windows Containers.\n\nStevedore can be used as a replacement for Docker Desktop, `DockerMsftProvider` or Mirantis Container Runtime.\n\n*Only Windows Containers are supported.*\n\n== Bundled components\n\n* https://github.com/moby/moby[Docker Engine]\n* https://github.com/docker/compose[Docker Compose]\n* https://github.com/docker/buildx[Docker Buildx]\n* https://github.com/docker/docker-credential-helpers[docker-credential-wincred]\n* https://github.com/containerd/containerd[containerd]\n* https://github.com/containerd/nerdctl[nerdctl]\n* https://github.com/microsoft/windows-container-networking[CNI plugins]\n\n== Supported OSes\n\n* Windows 10 starting with version 1809 (build 17763)\n* Windows 11\n* Windows Server 2019, 2022, 2025\n\n== Installation\n\n=== Manual\n\n. Download {uri-project}/releases/latest[MSI installer]\n. Double-click on it\n. Next-next-next\n. Reboot your computer.\nThis is needed to finish installation of Windows Containers feature and to add your user to `docker-users` group so user can access Docker service.\n\n=== Chocolatey\n\nStevedore is available via https://community.chocolatey.org/packages/stevedore[Chocolatey] package manager.\nIf you already have Chocolatey installed, you can just run the following command from elevated console:\n\n[source,powershell]\n----\nchoco install stevedore\n----\n\nThen reboot.\n\n=== WinGet\n\n[source,powershell]\n----\nwinget install stevedore\n----\n\nThen reboot.\n\n=== Advanced: Command-line install options\n\nStevedore installer supports several command-line options that may be handy to configure unattended installations.\n\nBasic usage: `msiexec /i c:\\path\\to\\stevedore.msi`.\n\nFor quiet (non-interactive) installation add `/quiet` option.\n\nIf you only want to install specific Stevedore features, use `ADDLOCAL=Feature1,Feature2,Feature3` syntax.\n\n.List of available MSI features for `ADDLOCAL`\n* `FeatureDockerd` installs Docker service.\n* `FeatureContainerd` installs containerd service.\n* `FeatureBuildkitd` installs BuildKit service.\n* `FeatureHyperV` installs Hyper-V support.\nIt allows running containers with https://docs.microsoft.com/en-us/virtualization/windowscontainers/manage-containers/hyperv-container#hyper-v-isolation[Hyper-V isolation].\n* `FeatureWincred` installs docker-credential-wincred.\n\nYou can also pass custom installation properties to Stevedore installer using `PROPERTY=value` syntax.\n\n.List of available MSI properties\n* `INSTALLDIR=%ProgramFiles%\\Stevedore` specifies directory where Stevedore executable files will be installed\n* `SERVICENAME=stevedore` specifies Windows service name\n\nWhen installing Stevedore via Chocolatey, use this syntax: `choco install stevedore --install-arguments=\"ADDLOCAL=Feature1,Feature2,Feature3 PROPERTY=value /quiet\"`\n\n== Usage\n\nAfter installation and reboot, `docker` command should be available on PATH and ready to use.\n\nYou may try `docker run --rm hello-world` from a command line to confirm that everything was set up properly.\n\nIn order to communicate with Docker engine, users needs to be in `docker-users` group.\nUpon installation, Stevedore automatically adds installing user to `docker-users`.\nIf you need other users to also access Docker engine, you will need to add them manually.\nYou can use https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.localaccounts/add-localgroupmember[Add-LocalGroupMember] PowerShell commandlet for that.\n\n=== Docker Compose\n\nStevedore installs two flavors of Docker Compose.\n\nYou can use Docker Compose V2 via `docker compose` command.\n\nYou can also use Docker Compose V1 compatibility mode via `docker-compose` command.\n\n=== Configuration and data files\n\nStevedore stores configuration and runtime data files for Windows containers under `%ProgramData%\\Docker` directory.\n\n[[containerd]]\n=== containerd, buildkitd and nerdctl\n\nStedevore has *experimental* support for Dockerless container environment.\n\nTo try it, enable *containerd* and *BuildKit* features in Stevedore installer.\n\nAfter installation (and reboot), you should be able to run containers using nerdctl:\n\n[source,shell]\n----\nnerdctl run --rm -it hello-world\n----\nNOTE: If you're getting `open \\\\\\\\.\\\\pipe\\\\containerd-containerd: Access is denied.\"` error, you need to run commands with elevated permissions.\nWhen https://github.com/containerd/containerd/issues/10454[this feature] is implemented, you will be able to use `nerdctr` from any user in `docker-users` group.\n\nYou can use `nerdctl build` to build containers.\n\nNOTE: There's an https://github.com/containerd/containerd/issues/10154[issue] with `nerdctl build`.\nIf you get `error: code = Unknown desc = write /dev/stdout: The pipe is being closed.`, add `--progress=plain` option.\n\nAdditionally, `ctr` and `buildctl` are available on `%PATH%`.\n\n== Building from source\n\n. https://www.rust-lang.org/tools/install[Install Rust]\n. Install https://wixtoolset.org/releases/https://wixtoolset.org/releases/[WiX Toolset] either manually or by running `choco install wixtoolset` if you have https://chocolatey.org/[Chocolatey]\n. Install Visual Studio 2019 or 2022.\nEnable \"Desktop development with {cpp}\" workload.\n. Clone Stevedore Git repository\n. Run `cargo install cargo-wix` to install https://github.com/volks73/cargo-wix[cargo-wix]\n. Run `cargo wix --nocapture` in repository root.\nReady-to-use MSI package will be built in `\u003crepo\u003e/target/wix` directory.\n\n[[no-more-linux-containers]]\n== Where Linux containers support is gone?\n\nBack in summer 2021, when this project was started, there were no known alternatives to Docker Desktop.\nContainer Desktop didn't exist yet, and Rancher Desktop just released initial 0.1.0 release.\n\nToday, things are very different.\nRancher Desktop provides both Docker and Kubernetes support, with a very advanced UI.\nStevedore is very unlikely to even come closer to Rancher Desktop functionality due to limited developer resources and lack of motivation.\n\nThus, starting with 0.10.0 release, Stevedore focuses on its primary goal - providing a convenient way to install Docker for Windows containers.\n\nIf you want to run Linux containers, consider one of these projects:\n\n* https://rancherdesktop.io/[Rancher Desktop] (Windows + Linux + Mac)\n* https://container-desktop.io/[Container Desktop] (Windows-only)\n* https://github.com/abiosoft/colima[Colima] (Mac-only)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslonopotamus%2Fstevedore","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fslonopotamus%2Fstevedore","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslonopotamus%2Fstevedore/lists"}