Installing Idem#
To install Idem, follow the steps for your operating system.
Where to find Idem#
Idem is a Python project hosted on pypi.org and is installable with the package installer for Python.
Python version requirements#
Idem requires Python 3.7 or later.
Linux#
To install Idem on Linux, follow these steps.
Ensure that all of your packages are up to date.
For Debian based distributions such as Ubuntu:
sudo apt-get update sudo apt-get upgrade -y
For RedHat based distributions such as CentOS:
sudo yum update -y
Install Python 3.7 or later. Include the package installer for Python (PIP).
For Debian based distributions such as Ubuntu:
sudo apt install -y python3-pip build-essential libssl-dev libffi-dev python-dev python3-venv
For RedHat based distributions such as CentOS:
sudo yum groupinstall -y development
(Optional) Create a virtual environment in which to run Idem.
mkdir environments cd environments python3 -m venv my_idem_env source my_idem_env/bin/activate
To meet encryption requirements, upgrade to the latest PIP.
python3 -m pip install --upgrade pip
Install the latest Idem version.
pip3 install idem
Alternatively, install a specific Idem version.
pip3 install idem==19.0.0
Verify your Idem version.
idem --version
Windows#
To install Idem on Windows, follow these steps.
Download and open the Python for Windows installer.
Select the option to add Python to the Windows PATH environment variable.
Run the installer, and follow the prompts.
In Windows, open Advanced system settings, click Environment Variables, and verify that the Python and PIP executables are included in the PATH system variable.
Open the Windows command prompt as an Administrator.
To meet encryption requirements, upgrade to the latest PIP.
python3 -m pip install --upgrade pip
Install Idem.
pip3 install idem
Verify your Idem version.
idem --version
MacOS#
To install Idem on MacOS, follow these steps.
From a terminal window, install the Homebrew package manager.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
Install Python 3.
brew install python
Homebrew installs PIP for you.
Add the Python directory to the PATH environment variable.
export PATH="/usr/local/opt/python/libexec/bin:$PATH"
(Optional) Create a virtual environment in which to run Idem.
mkdir environments cd environments python3 -m venv my_idem_env source my_idem_env/bin/activate
To meet encryption requirements, upgrade to the latest PIP.
python3 -m pip install --upgrade pip
Install the latest Idem version.
pip3 install idem
Alternatively, install a specific Idem version.
pip3 install idem==19.0.0
Verify your Idem version.
idem --version
What to do next#
Tell Idem what infrastructure to manage. See Connecting Idem to providers.