How to install opam

This page describes how to install and configure opam. For further help on how to use opam, either read opam --help or move on to the Usage guide.

Upgrading from a previous version

Generally, you should just reproduce the same installation steps as for the original installation: upgrade from your system's package manager, or re-run the binary installer. Opam will automatically update its internal repository at ~/.opam on first run if needed (if using our installer script, a backup can be made automatically).

To upgrade shell scripts, and enable sandboxing, don't forget to run opam init --reinit -ni.

Then see the Upgrade guide to check the changes.

Binary distribution

The quickest way to get the latest opam up and working is to run this script:

bash -c "sh <(curl -fsSL https://raw.githubusercontent.com/ocaml/opam/master/shell/install.sh)"

This will simply check your architecture, download and install the proper pre-compiled binary, backup your opam data if from an older version, and run opam init.

(If you have trouble with curl, just download the script and run sh install.sh)

We provide pre-compiled binaries for:

  • Linux (amd64, arm64, arm7, i686)
  • macOS (amd64, arm64)
  • FreeBSD (amd64)
  • OpenBSD (amd64)
  • We do not at present provide an official Windows distribution of opam, but please see this separately maintained distribution (other platforms are available using the other methods below)

If you don't like scripts, you can just pick your download here, put it in your PATH as opam, and set it as executable, e.g.

sudo install <downloaded file> /usr/local/bin/opam

Note that this script is intended for end-users, not CI. For that purpose, you can use pre-built Docker images for various configurations.

Using your distribution's package system

This is generally the recommended way, when available and up-to-date (you can check here the latest available release per distribution). Here is a list of supported distributions:

Arch Linux

badge

The opam package is available in the official distribution. To install it simply run:

pacman -S opam

If you'd like to use the development version there is an opam-git package available in the AUR. Assuming you have yay installed just run the following command:

yay -S opam-git

Debian

badge badge badge

Binary packages of opam are available for the stable, testing and unstable distributions, from the official repositories. You should be set with:

apt-get install opam

Exherbo

The dev-ocaml/opam package can be installed with the command:

cave resolve -x dev-ocaml/opam

You might need to add the ::ocaml-unofficial repository first:

cave resolve -x repository/ocaml-unofficial

Fedora, CentOS and RHEL

Fedora 32

The opam package for Fedora can be installed with the command:

dnf install opam

There is not currently a package for CentOS/RHEL. You will need to use our pre-built binaries, or build from sources.

Mageia

badge

The opam package for Mageia can be installed with the command:

urpmi opam

OpenBSD

badge

The opam package for OpenBSD can be installed with the command (since OpenBSD 5.7):

pkg_add opam

FreeBSD

badge

Opam is available in the ports and packages tree on FreeBSD 11 or higher.

pkg install ocaml-opam

or to install from source:

cd /usr/ports/devel/ocaml-opam
make install

macOS

badge badge

Opam packages for homebrew and MacPorts are available.

# Homebrew
brew install opam

# MacPort
port install opam

See also howto setup Emacs.app for Opam usage.

Ubuntu

badge

Versions 18.04 and newer

There is a ppa available that contains the current stable version of opam.

add-apt-repository ppa:avsm/ppa
apt update
apt install opam
Versions older than 18.04

Use the binary distribution. Instructions provided at https://opam.ocaml.org/doc/Install.html#Binary-distribution

Windows

Full support for Windows is planned for opam 2.2, and we expect to provide an opam package in Chocolatey and winget. If you'd like to help out, please get in touch!

Guix & Guix System

badge

The opam package for guix can be installed with the command:

# Guix
guix install opam

From Sources

Getting the Sources

Sources of the latest stable version of opam are available on Github:

You can also download the full archives, including opam dependencies (these don't require any extra downloads, just the OCaml compiler -- 4.02.3 or later for the latest version):

  • 2.1.0
    • MD5: 24dbfb43515e8edc617485f6c5853802
    • SHA384: ba4d375a1dea73937e8790c45c2fbd3d68ebbb0fddd2fd22af3e682037d50979abeda0c5cf17ffd8cc6a3951ff07242f

Follow the instructions in the included README.md to get opam built and installed from there.