Skip to content
envGo Latest version

Installation

envGo is a single executable with no runtime dependencies. Installing it means putting the binary on your PATH.

Don’t have the files yet? Grab them from Download. Otherwise pick the section for your platform below.

macOS — ZIP installer (easiest)

The release archive contains the installer script and the binary:

ArchiveFor
envGo-macOS-AppleSilicon.zipM-series Macs
envGo-macOS-Intel.zipIntel Macs

Not sure which you have? Run:

Terminal window
uname -m

arm64 means Apple Silicon; x86_64 means Intel.

Steps

  1. Extract the ZIP. You get a folder containing Install_envGo.command, a dist/ folder with the binary, and README.md.
  2. Double-click Install_envGo.command. It copies the binary to ~/.local/bin/envgo, marks it executable, and prints the help output.
  3. If ~/.local/bin is not on your PATH, the script tells you which line to add to ~/.zshrc.

macOS — manual install

Terminal window
# Extract the archive
unzip envGo-macOS-AppleSilicon.zip


# Install the binary and make it executable
mkdir -p ~/.local/bin
cp envGo-macOS-AppleSilicon/dist/envgo-darwin-arm64 ~/.local/bin/envgo
chmod +x ~/.local/bin/envgo

For an Intel Mac, use the Intel archive and dist/envgo-darwin-amd64.

Add to PATH if it is not there already:

Terminal window
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc
source ~/.zshrc

Linux

Terminal window
# AMD64 (most servers)
sudo cp dist/envgo-linux-amd64 /usr/local/bin/envgo
sudo chmod +x /usr/local/bin/envgo


# ARM64 (Raspberry Pi, Graviton, …)
sudo cp dist/envgo-linux-arm64 /usr/local/bin/envgo
sudo chmod +x /usr/local/bin/envgo

Or install into your home directory without sudo:

Terminal window
mkdir -p ~/.local/bin
cp dist/envgo-linux-amd64 ~/.local/bin/envgo
chmod +x ~/.local/bin/envgo

Check the architecture first if you are unsure:

Terminal window
uname -m      # x86_64 → amd64, aarch64 → arm64

Windows

The .exe is a console application — do not start it by double-clicking, because the console window closes the instant the process exits. Open a terminal and use envgo run dev instead.

Option 1 — PowerShell installer (recommended)

The installer detects AMD64/ARM64, verifies the SHA-256 entry in SHA256SUMS, installs the binary to %LOCALAPPDATA%\Programs\envGo, and adds that directory to your user PATH — all without admin rights.

Terminal window
# On default Windows the "Restricted" policy blocks scripts and you will see
# "cannot be loaded because running scripts is disabled". The
# -ExecutionPolicy Bypass flag fixes that for this one run only:
powershell -NoProfile -ExecutionPolicy Bypass -File .\Install_envGo.ps1 -Architecture amd64

Verify the installer and binary against SHA256SUMS before running them. SmartScreen may warn on first run because the binary is not code-signed — choose More info → Run anyway.

Option 2 — Manual install

Terminal window
# 1. Place the binary (pick the one matching your CPU — most PCs use amd64):
#    dist\envgo-windows-amd64.exe   ->   AMD64 (Intel/AMD)
#    dist\envgo-windows-arm64.exe   ->   ARM64 (Surface Pro X, etc.)
mkdir C:\envgo
copy $env:USERPROFILE\Downloads\envgo-windows-amd64.exe C:\envgo\envgo.exe

Then add C:\envgo to your PATH. Use either method below.

Method A — PowerShell (no admin rights):

Terminal window
# Run once in a new PowerShell window:
[Environment]::SetEnvironmentVariable(
  'Path',
  [Environment]::GetEnvironmentVariable('Path', 'User') + ';C:\envgo',
  'User'
)

Method B — Windows GUI (visual):

  1. Press Win + R, type sysdm.cpl, press Enter.
  2. Advanced tab → Environment Variables….
  3. Under User variables select Path → Edit….
  4. New → type C:\envgo → OK to close every dialog.
  5. Open a new PowerShell window.

PATH changes only apply to terminals opened after the edit. Reopen the terminal if envgo is not recognized.

Open a new terminal, then verify:

Terminal window
envgo -v

Building from source

Requires Go 1.21 or newer.

Terminal window
git clone <repository>
cd <repository>
make build          # → ./envgo

The Makefile uses CGO_ENABLED=0 and -trimpath -ldflags="-s -w", so the result is a static, stripped binary. To build every platform into dist/:

Terminal window
make release

Verify

Terminal window
envgo -v      # print the version
envgo -h      # show the flag reference

A successful install prints something like:

 ____
   ___ _ ____   __/ ___| ___
  / _ \ '_ \ \ / / |  _ / _ \
 |  __/ | | \ V /| |_| | (_) |
  \___|_| |_|\_/  \____|\___/
  envGo v1.0.10 — Zero-dependency micro-runtime for HTML/Vanilla JS
  Secure .env injection — secrets never reach the browser


envGo v1.0.10

Create your first project

Terminal window
mkdir myapp && cd myapp
envgo init
envgo run dev

envgo init writes .env, .env.example, index.html, .gitignore, and README.md into the current directory. See Quick Start for the walkthrough.

Uninstall

envGo is one file — remove it and the install is gone.

Terminal window
# macOS / Linux, user install
rm ~/.local/bin/envgo


# Linux, system install
sudo rm /usr/local/bin/envgo


# Windows
del C:\envgo\envgo.exe

If an older release was installed under the previous name, remove that too:

Terminal window
rm -f ~/.local/bin/envbridge

Troubleshooting

ProblemFix
envgo: command not foundThe install directory is not on PATH — add it and open a new shell
bad CPU type in executableWrong architecture. Check uname -m and install the matching binary
Permission deniedchmod +x the binary, or install to a user-writable directory
Gatekeeper blocks the binaryRight-click → Open, or xattr -dr com.apple.quarantine <folder>
SmartScreen blocks the binaryChoose More info → Run anyway
cannot execute binary file on LinuxWrong architecture, or the file was transferred as text — re-copy it
cannot be loaded because running scripts is disabled on WindowsRun the installer with powershell -NoProfile -ExecutionPolicy Bypass -File .\Install_envGo.ps1 — Restricted (default) blocks all scripts

Next steps