Install

Conan can be installed in many Operating Systems. It is extensively used and tested in Windows, Linux (different distros), OSX, and also actively used in FreeBSD and Solaris SunOS, but it has been reported to work in other systems too.

There are three ways to install conan:

  1. The preferred and strongly recommended way to install conan is from PyPI, the Python Package Index, with the pip command.
  2. There are other available installers for different systems, which might come with a bundled python interpreter, so it is not necessary to install python first. Please note that some of these installers might have some limitations, specially those created with pyinstaller (like Windows exe & Linux deb).
  3. Running conan from sources.

Install from brew (OSX)

There is a brew recipe, so in OSX, you can install conan with

$ brew update
$ brew install conan

Install from AUR (Arch Linux)

You can find the package here. The easiest way is using pacaur tool:

$ pacaur -S conan

Or you can also use makepkg and install it following the AUR docs: installing packages.

Just remember to install four conan dependencies first. They are not in the official repositories but there are in AUR repository too:

  • python-patch
  • python-node-semver
  • python-distro
  • python-pluginbase

Install the binaries

Go to the conan website and download the installer for your platform!

Execute the installer. You don’t need to install python.

Note

You can also use the latest version’s links to download the latest installer:

http://downloads.conan.io/latest_debian
http://downloads.conan.io/latest_windows

Initial configuration

Let’s check if conan is correctly installed. Execute in your console:

$ conan

You will see something similar to:

Conan commands. Type $conan "command" -h for help
    alias          Creates and export an alias recipe
    build          Utility command to run your current project 'conanfile.py' build() method.
    config         Manages conan configuration information
    copy           Copy conan recipes and packages to another user/channel.
    ...

Install from source

You can run conan directly from source code. First you need to install Python 2.7 and pip. From 0.9 conan has “experimental/testing” Python3 support too.

Clone (or download and unzip) the git repository and install its requirements:

$ git clone https://github.com/conan-io/conan.git
$ cd conan
$ pip install -r conans/requirements.txt

Create a script to execute conan and add it to your PATH.

#!/usr/bin/env python

import sys

conan_repo_path = "/home/your_user/conan" # ABSOLUTE PATH TO CONAN REPOSITORY FOLDER

sys.path.append(conan_repo_path)
from conans.client.command import main
main(sys.argv[1:])

Test your conan script.

$ conan

You should see the conan commands help.