Installing Portamos

Download

The latest release is v0.0.1-beta.29.

Download the binary for your platform:

Platform	File
Linux (x86-64)	portamos-linux-amd64
macOS (ARM / Apple Silicon)	portamos-macos-aarch64
Windows (x86-64)	portamos-windows-amd64.exe
Fat JAR (any platform with Java 21+)	portamos-all.jar

The native binaries are self-contained — no JVM installation is required. The fat JAR requires Java 21 or later; run it with java -jar portamos-all.jar.

Archive contents

Each release archive contains:

portamos          (or portamos.exe on Windows)
README.md
definitions/
  README.md
  turboplus.json
  amcaf.json

The definitions/ directory contains JSON definition files for known third-party AMOS extensions. Place it alongside the binary so Portamos can find them with --definition definitions/turboplus.json.

Installation

Linux and macOS

Extract the archive and place the contents in a dedicated directory:

mkdir -p ~/portamos
tar -xzf portamos-*-linux-amd64.tar.gz -C ~/portamos   # adjust filename for your platform

Add the directory to your PATH by appending this line to ~/.bashrc, ~/.zshrc, or your shell’s equivalent:

export PATH="$HOME/portamos:$PATH"

Reload your shell or run source ~/.bashrc (or ~/.zshrc), then verify:

portamos --version

Windows

Create a folder, for example C:\portamos.
Extract portamos-*-windows-amd64.zip into that folder.
Open System Properties → Advanced → Environment Variables.
Under User variables, select Path and click Edit.
Click New and add C:\portamos.
Click OK to close all dialogs.
Open a new Command Prompt or PowerShell window and verify:

portamos --version