Skip to content

Latest commit

 

History

History
157 lines (100 loc) · 4.25 KB

installation.rst

File metadata and controls

157 lines (100 loc) · 4.25 KB
Raw

Install

To install the conan client you can use one of the provided installers, or run it directly from source code.

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
http://downloads.conan.io/latest_macos

Install with pip

You need a python 2.7 distribution installed in your machine. From 0.9 conan has "experimental/testing" Python3 support too.

  • Install pip following pip docs
  • Install conan:
$ pip install conan

Note

  • Please make sure that your pip installation matches your python (2.7 or 3.X) one.
  • In Linux if you want to install it globally, you might need sudo permissions.
  • We strongly recommend using virtualenvs (virtualenvwrapper works great) for everything python related
  • In Windows you might need to use 32bits python distributions, instead of 64bits.
  • In OSX, specially latest versions that might have System Integrity Protection, pip might fail. Try with virtualenvs, or install with other user $ pip install --user conan

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-monotonic
  • python-fasteners
  • python-node-semver

Initial configuration

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

$ conan

You will see something similar to:

It seems to be the first time you run conan
Auto detecting your dev setup to initialize conan.conf
Found Visual Studio 9
Found Visual Studio 12
Found Visual Studio 14
Found gcc 4.8
Found clang 3.7
Default conan.conf settings
        os=Windows
        arch=x86_64
        compiler=Visual Studio
        compiler.version=14
        compiler.runtime=MD
        build_type=Release
*** You can change them in ~/.conan/conan.conf ***
*** Or override with -s compiler='other' -s ...s***

As you can see, on first execution, conan performs a basic detection of your installed tools and saves the details in the conan.conf file (under your user home directory ~/.conan/conan.conf). These auto-detected settings are just a convenience and act as a default for your conan commands. You can change them at any time in this file or override them on the command line with new values. You can also delete them from conan.conf, in which case you will have to fully specify them for new projects.

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.