Installing ansible-navigator with execution environment support

Linux

Requirements

Install the desired container engine for execution environment support

Install ansible-navigator

  1. Install the python package manager using the system package installer (e.g.):

    sudo dnf install python3-pip
    
  2. Install ansible-navigator:

    python3 -m pip install ansible-navigator --user
    
  3. Add the installation path to the user shell initialization file (e.g.):

    echo 'export PATH=$HOME/.local/bin:$PATH' >> ~/.profile
    
  4. Refresh the PATH (e.g.):

    source ~/.profile
    
  5. Launch ansible-navigator:

    ansible-navigator
    
  6. ansible-navigator triggers a one-time download of the demo execution-environment image.

macOS

Requirements

Install the desired container engine for execution environment support

Note

There is no convenient way to use ansible-navigator with podman on macOS. Native source mounts from macOS through the podman machine into the execution environment are not currently available.

See this related issue for details.

Install ansible-navigator

  1. Install the command line developer tools and proceed with the installation if prompted.

    xcode-select install
    
  2. Install ansible-navigator:

    pip3 install ansible-navigator --user
    
  3. Add the installation path to the PATH:

    echo 'export PATH=$HOME/Library/Python/3.8/bin:$PATH' >> ~/.zprofile
    
  4. Refresh the PATH:

    source ~/.zprofile
    
  5. Launch ansible-navigator:

    ansible-navigator
    
  6. ansible-navigator triggers a one-time download of the demo execution-environment image.

Windows with WSL2

Requirements

Setup Windows Subsystem for Linux 2 with Ubuntu

  1. Install Windows Subsystem for Linux 2.

  2. Install the Ubuntu 20.04 LTS Linux distribution from the Microsoft store.

  3. Open PowerShell and set the default WSL 2 distribution:

    wsl --set-default ubuntu
    
  4. Launch the Ubuntu] virtual machine from the Windows menu and complete the initial set-up.

  5. From the Ubuntu terminal, create the /dev/mqueue directory:

    sudo mkdir /dev/mqueue
    

Install the desired container engine for execution environment support

  • Installation instructions for podman on Ubuntu 20.04 LTS.

    Note

    The podman package is available in the official repositories for Ubuntu 20.10 and newer. Since interim releases of Ubuntu are not available on the Microsoft Store for WSL the Kubic project package can be used.

    1. Update the ubuntu package index:

      sudo apt update
      
    2. Install system dependencies for podman:

      apt-get install curl wget gnupg2
      
    3. Source the Ubuntu release:

      source /etc/os-release
      
    4. Add the podman repository:

      sudo sh -c "echo 'deb http://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable/xUbuntu_${VERSION_ID}/ /' > /etc/apt/sources.list.d/devel:kubic:libcontainers:stable.list"
      
    5. Download the GPG key:

      wget -nv https://download.opensuse.org/repositories/devel:kubic:libcontainers:stable/xUbuntu_${VERSION_ID}/Release.key -O- | sudo apt-key add -
      
    6. Update using the new repository:

      sudo apt-get update
      
    7. Install podman:

      sudo apt-get install podman
      
  • Follow the Docker Desktop for Windows installation instructions (if podman was not installed above)

Install ansible-navigator

From the Ubuntu terminal:

  1. Ensure the /dev/mqueue directory exists:

    sudo mkdir /dev/mqueue
    
  2. Install the python package manager:

    sudo apt install python3-pip
    
  3. Install ansible-navigator:

    python3 -m pip install ansible-navigator --user
    
  4. Add the installation path to the user shell initialization file:

    echo 'export PATH=$HOME/.local/bin:$PATH' >> ~/.profile
    
  5. Refresh the PATH:

    source ~/.profile
    
  6. Launch ansible-navigator:

    ansible-navigator
    
  7. ansible-navigator triggers a one-time download of the demo execution-environment image.