How to install opam
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
Then see the Upgrade guide to check the changes.
The quickest way to get the latest opam up and working is to run this script:
sh <(curl -sL 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
(If you have troule with
download the script
We provide pre-compiled binaries for:
- Linux i686, amd64, arm7, arm64
- OSX (intel 64 bits) (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 cp <downloaded file> /usr/local/bin/opam sudo chmod a+x /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. Here is a list of supported distributions:
The opam package is available in the official distribution. To install it simply run:
pacman -S opam
yaourt -S opam-git
apt-get install 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
No native packages at the moment, you will need to use our pre-built binaries, or build from sources.
The opam package for Mageia can be installed with the command:
Opam builds via sources fine on OpenBSD 5.6 or earlier, and is available in the ports and packages tree on OpenBSD 5.7 or higher.
cd /usr/ports/sysutils/opam make install
Opam is available in the ports and packages tree on FreeBSD 11 or higher.
cd /usr/ports/devel/ocaml-opam make install
brew install opam # Homebrew port install opam # MacPort
See also howto setup Emacs.app for Opam usage.
Ubuntu has native packages for opam:
apt install opam
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.0.0~rc MD5: 6e89905dbe9203dee3e883b70e210285 SHA384: 8a9ee03cdcd78a7d44e92c9b1c6e841605a49ecff4ebd977a632708ef6250f9f3ec488ecd1852f76d1b6cfc2d8ad9117
- 1.2.2 MD5: 7d348c2898795e9f325fb80eaaf5eae8 SHA384: 3a0a7868b5f510c1248959ed350eecacfe1abd886e373fd31066ce10871354010ef057934df026e5fad389ead6c2857d
Follow the instructions in the included
README.md to get opam built and
installed from there.
Note that opam1.2.2 doesn't build from source with OCaml 4.06.0. Use this command to compile
OCAMLPARAM="safe-string=0,_" make lib-ext
ocamlbrew is a script that can bootstrap an OCaml environment including opam, from source. This option does not require an existing OCaml installation, or a pre-compiled opam binary for your platform. To bootstrap a new OCaml environment including opam, make sure that you have the necessary pre-requisites installed to run ocamlbrew, and then run:
curl -kL https://raw.github.com/hcarty/ocamlbrew/master/ocamlbrew-install | env OCAMLBREW_FLAGS="-r" bash