Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Installing dune

dune (and its package runner dunx) ships as one prebuilt executable per platform, attached to every j8 release on GitHub and published to npm.

macOS and Linux

curl -fsSL https://j8.app238.com/install | bash

The script picks the build for your machine (x64 or arm64; glibc or musl on Linux; the native build under Rosetta), checks it against the release’s SHA256SUMS, puts dune and the dunx link in ~/.dune/bin and adds that directory to PATH in your shell’s startup file (bash, zsh or fish).

A given release:

curl -fsSL https://j8.app238.com/install | bash -s v0.4.0

Windows

powershell -c "irm https://j8.app238.com/install.ps1 | iex"

Installs dune.exe and dunx.exe to %USERPROFILE%\.dune\bin and adds it to the user PATH. A given release:

& ([scriptblock]::Create((irm https://j8.app238.com/install.ps1))) -Version v0.4.0

npm

npm install -g @jabberwocky238/dune

npm installs only the platform package that fits (@jabberwocky238/dune-linux-x64, @jabberwocky238/dune-darwin-arm64, @jabberwocky238/dune-win32-x64 …) and the postinstall script puts its binary in place, so dune starts without Node.

Cargo

cargo install j8dune     # the name dune is taken on crates.io; then ln -s dune ~/.cargo/bin/dunx

Upgrading

dune upgrade             # the latest release
dune upgrade --tag v0.4.0

dune upgrade downloads the release for its own platform from GitHub, verifies the checksum and replaces itself (and dunx when it is a copy rather than a link).

Settings

Variable
DUNE_INSTALLinstall root for the scripts (default ~/.dune; binaries in its bin/)
DUNE_RELEASESwhere the scripts download releases from (default https://github.com/0x00-Community/j8/releases)

Platforms

PlatformRelease archiveJIT
Linux x64 (glibc 2.17+ / musl)dune-linux-x64.tar.gz / dune-linux-x64-musl.tar.gzyes
Linux arm64 (glibc 2.17+ / musl)dune-linux-arm64.tar.gz / dune-linux-arm64-musl.tar.gzno
macOS x64 / arm64dune-darwin-x64.tar.gz / dune-darwin-arm64.tar.gzx64 only
Windows x64 / arm64dune-win32-x64.tar.gz / dune-win32-arm64.tar.gzno

The JIT emits x86-64 machine code on Unix; elsewhere --jit prints a notice and runs on the interpreter.

Uninstalling

Delete ~/.dune (or %USERPROFILE%\.dune) and the lines the script added to your shell’s startup file (marked # dune), or npm uninstall -g @jabberwocky238/dune.