macOS 11+

  • Minimum Requirements

    • macOS 11 (Big Sur)

    • 4th Gen Intel® Core CPU or later

    • 8 GiB of RAM

  • Recommended

    • macOS 11 (Big Sur)

    • Apple Silicon CPU

    • 16 GiB of RAM

Installing Nix

Simply run this (entire) command in Terminal.app:

$ curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix/pr/1145 | sh -s -- install --no-confirm --extra-conf "
    extra-substituters = https://openlane.cachix.org
    extra-trusted-public-keys = openlane.cachix.org-1:qqdwh+QMNGmZAuyeQJTH9ErW57OWSvdtuwfBKdS254E=
"

Enter your password if prompted. This should take around 5 minutes.

Make sure to close all terminals after you’re done with this step.

If you already have Nix set up…

You will need to enable OpenLane’s Binary Cache manually.

If you don’t know what that means:

We use a service called Cachix, which allows the reproducible Nix builds to be stored on a cloud server so you do not have to build OpenLane’s dependencies from scratch on every computer, which will take a long time.

First, you want to install Cachix by running the following in your terminal:

$ nix-env -f "<nixpkgs>" -iA cachix

Then set up the OpenLane binary cache as follows:

$ sudo env PATH="$PATH" cachix use openlane

…and restart the Nix daemon.

$ sudo pkill nix-daemon

If you do know what this means, the values are as follows:

extra-substituters = https://openlane.cachix.org
extra-trusted-public-keys = openlane.cachix.org-1:qqdwh+QMNGmZAuyeQJTH9ErW57OWSvdtuwfBKdS254E=

Make sure to restart nix-daemon after updating /etc/nix/nix.conf.

$ sudo pkill nix-daemon

Cloning OpenLane

With git installed, just run the following:

$ git clone https://github.com/efabless/openlane2

That’s it. Whenever you want to use OpenLane, nix-shell in the repository root directory and you’ll have a full OpenLane environment. The first time might take around 10 minutes while binaries are pulled from the cache.

To quickly test your installation, simply run openlane --smoke-test in the nix shell.