Range
Opens shells inside remote container images and datasets without downloading them first.
Tested on macOS and Linux
Use it
macOS arm64
You need first
- Runtimes:
Go 1.25 or newer - System packages:
QEMU - A GPU is optional
download and extract release binary range_Darwin_arm64.tar.gz
curl -fsSL https://github.com/andreygrehov/range/releases/latest/download/range_$(uname -s)_$(uname -m).tar.gz | tar -xz && ls -lh range* 2>&1; ls -lh *.range 2>&1; file range
Where the README and reality differ
- README: range --version
What worked: range has no --version flag (exits 'unknown command --version'); use --help instead
Check that it works
./range --version 2>&1; echo "---"; ./range --help 2>&1The output should contain “range — use a remote environment before downloading it”.
First thing to try
./range doctor 2>&1Run ./range doctor first to check that your system is ready.
Linux x86_64
You need first
- Runtimes:
Go 1.25 or newer - System packages:
QEMU - A GPU is optional
download release tarball via curl and extract
curl -fsSL https://github.com/andreygrehov/range/releases/latest/download/range_$(uname -s)_$(uname -m).tar.gz | tar -xzcopy binary to ~/.local/bin on PATH
mkdir -p ~/.local/bin && cp ./range ~/.local/bin/range && chmod +x ~/.local/bin/range
Where the README and reality differ
- README: README shows curl | tar pipeline and ./range doctor, implies --version
What worked: --version is unknown command; use --help; binary runs as ./range then needs move to ~/.local/bin
Check that it works
range --helpThe output should contain “range — use a remote environment”.
First thing to try
mkdir -p /tmp/mydir3 && echo "hello world" > /tmp/mydir3/file.txtrange build /tmp/mydir3 -o /tmp/test3.rangeRun ./range doctor first to check that your system is ready.
What it does
- Build your own environment artifactsTested
How to use it
- See the build options with
./range build --help. - Build an artifact from a container image with
./range build --from-oci <image> -o <file>.range.
- See the build options with
- Open a shell inside a remote image without downloading itNot tested
- Run commands with mounts, ports and variablesNot tested
- Run isolated sessions with resource limitsNot tested
How far pickfit got
macOS arm64
- Installs
- Starts
- 1 of 4 features work
- Works offline
Linux x86_64
- Installs
- Starts
- 1 of 4 features work
- Works offline
Other systems
Good for
- open a shell inside a container image
- run a Python app with current directory mounted
- run a server with published port and env variable
An alternative to Docker.
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
macOS arm64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 1 Nov 2026
Differences the test machine hit
- README: On a Mac with Apple silicon and macOS 14+ Range boots a small Linux VM with Virtualization.framework and range doctor says if host can run
In the test: range doctor reported 'This host can run range shell' but every 'range run/shell' failed with VZErrorDomain Code=2 Virtualization is not available on this hardware (nested virtualization unavailable in this VM)
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 1 Nov 2026
Differences the test machine hit
- README: Prerequisites list Go 1.25 and QEMU/KVM
In the test: binary install needs no Go; QEMU/root/nbd only needed at runtime, doctor reports MISSING root and nbd on sandbox