Installing Wolang

Linux

Last updated Invalid DateVersion 1.0.0

The one-line way

Linux

Shell
curl -fsSL https://raw.githubusercontent.com/MowoGames/Wolang/alpha/install.sh | sh

macOS

Releases carry no macOS archive for now (the project's CI has no macOS runners), so the script builds it from source. That needs the Xcode command line tools and CMake:

Shell
curl -fsSL https://raw.githubusercontent.com/MowoGames/Wolang/alpha/install.sh | sh -s -- --from-source

Windows

Download wolang-<version>-x86_64.msi from the releases and run it: it installs under Program Files, puts wolang on the PATH, and appears in Add/Remove Programs like anything else. Silently, for a fleet:

PowerShell
msiexec /i wolang-1.3.0-x86_64.msi /qn

Or, without the installer:

PowerShell
irm https://raw.githubusercontent.com/MowoGames/Wolang/alpha/install.ps1 | iex

Either one downloads the build for your machine, checks it against the published checksum, unpacks it under ~/.wolang (or %LOCALAPPDATA%\Wolang), and puts it on your PATH. Nothing is written outside that directory and nothing asks for a password.

Then:

Shell
wolang new hello && cd hello && wolang run .

Installing 1.3.0

Shell
curl -fsSL https://raw.githubusercontent.com/MowoGames/Wolang/alpha/install.sh | sh -s -- --version 1.3.0
wolang --version

That prints wolang 1.3.0. The scripts check the download against the release's SHA256SUMS and stop if the checksum is wrong or missing. To check an archive yourself, see "By hand" below. To find the newest release without naming it, leave --version out.

Reading it first

Piping a script into a shell is a thing to be uneasy about. Both scripts are short and have no network calls beyond GitHub:

Shell
curl -fsSL https://raw.githubusercontent.com/MowoGames/Wolang/alpha/install.sh -o install.sh
less install.sh
sh install.sh

Options

--version 1.3.0A particular release rather than the newest (v1.3.0 works too)
--no-verifySkip the checksum check. Without this, a release with no checksum for your archive is refused
--prefix /opt/wolangSomewhere else
--from-sourceClone and build instead of downloading
--no-modify-pathLeave the shell profile alone
--uninstallTake it away
Shell
sh install.sh --version 1.3.0 --prefix /opt/wolang

PowerShell takes the same as named parameters:

PowerShell
.\install.ps1 -Version 1.3.0 -Prefix C:\tools\wolang -NoModifyPath

Building the installer yourself

PowerShell
dotnet tool install --global wix --version 6.0.2
wix extension add -g WixToolset.UI.wixext/6.0.2
cmake --preset windows -DCMAKE_BUILD_TYPE=Release
cmake --build --preset windows -j
pwsh tools/package/make_msi.ps1 -Build build/windows

That writes build\wolang-<version>-x86_64.msi.

By hand

Every release has an archive per platform and a SHA256SUMS beside them:

Shell
v=1.3.0
curl -fLO "https://github.com/MowoGames/Wolang/releases/download/v$v/wolang-linux-x86_64.tar.gz"
curl -fLO "https://github.com/MowoGames/Wolang/releases/download/v$v/SHA256SUMS"
sha256sum -c SHA256SUMS --ignore-missing
tar -xzf wolang-linux-x86_64.tar.gz
export PATH="$PWD/wolang-linux-x86_64/bin:$PATH"

What is in the archive:

Text
bin/wolang               the driver
lib/std, lib/http, ...   the libraries, as sources
lib/libwolang_*.a        the runtime and the embedding library
include/wolang/          the headers, for embedding
lib/cmake/Wolang/        find_package(Wolang CONFIG)
lib/pkgconfig/           pkg-config --cflags wolang-embed

From source

Shell
git clone https://github.com/MowoGames/Wolang && cd Wolang
cmake --preset release && cmake --build --preset release -j
cmake --install build/release --prefix ~/.local

The full guide, including what each system needs and why it is clang, is building.md.

The editor

Shell
code --install-extension wolang-1.3.0.vsix     # from the release

Or build it yourself — no npm needed:

Shell
python3 tools/package/make_vsix.py

Zed, Neovim, Sublime Text, Emacs, Helix and the JetBrains family are supported too; see editors/README.md.

Platforms

BuiltTested in CI
macOS arm64from source— (no macOS runners)
macOS x86-64from source—
Linux x86-64yesyes
Linux arm64yesyes
Windows x86-64yesyes
Windows arm64through emulation—
FreeBSDfrom source—
WebAssemblywolang build --target wasm32-unknown-unknown emits an object—

Keeping it up to date

Run the installer again; it replaces current and leaves your PATH alone.

Removing it

Shell
sh install.sh --uninstall        # or: .\install.ps1 -Uninstall

The line it added to your shell profile stays; take it out by hand. The installer only ever writes under its prefix (~/.wolang), so removing that directory is the whole uninstall. A release made with the .msi is removed in Add/Remove Programs.

Page feedback

Was this page helpful?