Installation options

The current release is for Mac OS X, 64-bit Linux, and Windows users!

Option 1: Installing or updating using Homebrew
Option 1: Installing or updating using Homebrew

First install homebrew if you haven't already.

Then from the command line enter these commands (or better yet, paste them into your console):

brew tap unisonweb/unison
brew install unison-language

This will install the Unison codebase manager executable ucm. If you're upgrading from a previous version, just do brew upgrade unison-language.

Note: if you get prompted for a GitHub username and password at this point, make sure you spelled unisonweb/unison correctly.

Option 2: Install Debian / Ubuntu users
Option 2: Install Debian / Ubuntu users

Unison Stable Release

curl shttp://debian.unison-lang.org/public.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/unison-computing.gpg
echo 'deb [arch=amd64 signed-by=/etc/apt/trusted.gpg.d/unison-computing.gpg] https://debian.unison-lang.org/ bookworm main' | sudo tee /etc/apt/sources.list.d/unison-computing.list
sudo apt update
sudo apt install unisonweb
/usr/bin/ucm

Unison Nightly Release

sudo apt install apt-transport-https
curl https://debian.unison-lang.org/public.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/unison-computing.gpg
echo 'deb [arch=amd64 signed-by=/etc/apt/trusted.gpg.d/unison-computing.gpg] https://debian.unison-lang.org/ bookworm nightly' | sudo tee /etc/apt/sources.list.d/unison-computing.list
sudo apt update
sudo apt install unisonweb
/usr/bin/ucm
Option 3: Install manually for Mac and Linux users
Option 3: Install manually for Mac and Linux users

Linux

mkdir -p unisonlanguage && cd unisonlanguage
curl -L https://github.com/unisonweb/unison/releases/latest/download/ucm-linux-x64.tar.gz \
	| tar -xz
./ucm

Mac (Intel)

mkdir -p unisonlanguage && cd unisonlanguage
curl -L https://github.com/unisonweb/unison/releases/latest/download/ucm-macos-x64.tar.gz \
  | tar -xz
./ucm

Mac (Apple Silicon)

mkdir -p unisonlanguage && cd unisonlanguage
curl -L https://github.com/unisonweb/unison/releases/latest/download/ucm-macos-arm64.tar.gz \
  | tar -xz
./ucm
Option 4: Install manually for Windows users
Option 4: Install manually for Windows users
  1. Set your default terminal application to “Windows Terminal” for best results. Search for “Terminal” in Settings, or follow this how-to.
  2. Download UCM and extract it to a location of your choosing.
  3. Run ucm.exe 🎉
Option 5: Nix installation
Option 5: Nix installation
Head to https://github.com/ceedubs/unison-nix/#usage and follow the instructions in the readme there.

Unison Desktop app installation

The Unison Desktop app offers a rich graphical interface for viewing your local Unison codebase. You can click-through to source definitions, search for Unison terms in your project, and read the API docs of your library dependencies. Install the UCM-Desktop app here.

Unison Language Server installation

Unison has a Language Server Protocol (LSP) integration! Instructions for downloading and setting up the Unison Language Server are available here.