v0.6.0

func-e v0.6.0 introduces Windows support! This means you can run Envoy on Windows without using Docker.

func-e is available as an MSI download or via winget.

winget is the default package manager for Windows 11 and is scheduled for a Windows 10 service release

Installing this way is as easy as this:

C:\> winget install func-e
C:\> func-e run -c envoy.yaml
:: If you don't have a configuration file, you can start the admin port like this
C:\> func-e run --config-yaml "admin: {address: {socket_address: {address: '127.0.0.1', port_value: 9901}}}"

Background

The Envoy project supported Windows via Docker since version 1.18.3. However, this is a little harder than it sounds for first time users.

For example, Docker in Windows has compatibility rules that imply knowing details about how the images were built. Those using Windows 10 Home probably won't get it to work at all. The first step was repackaging envoy binaries into the Tetrate Labs archive so that you don't need Docker to run them.

The rest of the work was in the func-e codebase itself. While golang has a decent amount of portability, there are many details left out before you can control the process and erase differences like newline consistency (\r\n). It was more work than the go code, as we prioritize maintenance experience as much as user experience.

For example, we needed to setup CI and reorganize doc generation so that maintainers don't need to run windows in order to fix glitches or perform releases. All of the above, making things work, and not add risk into our build.. ended up as 2 months of small changes.

The primary thanks here goes to the Envoy team who of course make Windows possible via publishing images. The func-e team on this effort were @codefromthecrypt and @mathetake. Of course, we also have the users to thank, especially their patience in waiting for us. We hope this helps you try Envoy!