{"id":2167,"date":"2024-10-04T19:49:00","date_gmt":"2024-10-04T17:49:00","guid":{"rendered":"https:\/\/robermb.com\/blog\/?p=2167"},"modified":"2024-10-04T15:11:49","modified_gmt":"2024-10-04T13:11:49","slug":"how-to-install-ansible-navigator-on-macos","status":"publish","type":"post","link":"https:\/\/robermb.com\/blog\/geeks\/how-to-install-ansible-navigator-on-macos\/","title":{"rendered":"How to Install Ansible Navigator on macOS"},"content":{"rendered":"\n<p>Ansible Navigator is an essential tool for managing Ansible automation more effectively. In this guide, I&#8217;ll walk you through the steps to install Ansible Navigator on your macOS system.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Prerequisites<\/h2>\n\n\n\n<p>Before you start, ensure you have the following:<\/p>\n\n\n\n<ul>\n<li><a href=\"https:\/\/hub.docker.com\/editions\/community\/docker-ce-desktop-mac\">Docker Desktop for Mac<\/a>&nbsp;or&nbsp;<a href=\"https:\/\/podman.io\/docs\/installation#macos\">Podman on macOS<\/a>. I personally choose Docker Desktop.<\/li>\n\n\n\n<li>macOS command line developer tools(xcode).<\/li>\n\n\n\n<li>Internet access (during initial installation).<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Step 1: Install xcode<\/h2>\n\n\n\n<p>You can install these tools by running:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>xcode-select --install<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Step 2: Install Ansible Navigator<\/h2>\n\n\n\n<p>Once you have the container engine set up, you can proceed to install Ansible Navigator. Open your terminal and run the following command:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>pip3 install ansible-navigator --user<\/code><\/pre>\n\n\n\n<p>This command will install Ansible Navigator in your user environment.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Step 3: Add the Installation Path to the PATH<\/h2>\n\n\n\n<p>After the installation, you&#8217;ll need to add the installation path to your&nbsp;<code>PATH<\/code>&nbsp;environment variable. Use the installed Python version to do this. Run the following command:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>echo 'export PATH=$HOME\/Library\/Python\/3.10\/bin:$PATH' &gt;&gt; ~\/.zprofile<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Step 4: Refresh the PATH<\/h2>\n\n\n\n<p>To apply the changes you made to the&nbsp;<code>PATH<\/code>, refresh it by running:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>source ~\/.zprofile<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Step 5: Launch Ansible Navigator<\/h2>\n\n\n\n<p>Now you can launch Ansible Navigator by running:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>ansible-navigator<\/code><\/pre>\n\n\n\n<p>The first time you launch it, Ansible Navigator will trigger a one-time download of the demo execution environment image.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>---------------------------------------------------------------------\nExecution environment image and pull policy overview\n---------------------------------------------------------------------\nExecution environment image name:     ghcr.io\/ansible\/creator-ee:v0.22.0\nExecution environment image tag:      v0.22.0\nExecution environment pull arguments: None\nExecution environment pull policy:    tag\nExecution environment pull needed:    True\n---------------------------------------------------------------------\nUpdating the execution environment\n---------------------------------------------------------------------\nRunning the command: docker pull ghcr.io\/ansible\/creator-ee:v0.22.0\nv0.22.0: Pulling from ansible\/creator-ee\n5cdf3ed22655: Pull complete \n05f157bf0bc5: Pull complete \n32db66e6bbce: Pull complete \n92e1f4a92098: Pull complete \n4b6189431dbc: Pull complete \n2764fac24a7d: Pull complete \nd419ad167630: Pull complete \n7d401e59b8b6: Pull complete \n2d3d51bbd587: Pull complete \n0ca12ab343b6: Pull complete \na08b983c8468: Pull complete \n8cf7db6949e0: Pull complete \n81119f8f5261: Pull complete \nDigest: sha256:2edd3559b9fa2f3a386d078bff531874a1d30455f8171d027cf3a9c7f50118d4\nStatus: Downloaded newer image for ghcr.io\/ansible\/creator-ee:v0.22.0\nghcr.io\/ansible\/creator-ee:v0.22.0<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Execution Environment Image and Pull Policy Overview<\/h3>\n\n\n\n<ul>\n<li><strong>Execution environment image name:<\/strong>\u00a0<code>ghcr.io\/ansible\/creator-ee:v0.22.0<\/code><\/li>\n\n\n\n<li><strong>Execution environment image tag:<\/strong>\u00a0<code>v0.22.0<\/code><\/li>\n\n\n\n<li><strong>Execution environment pull arguments:<\/strong>\u00a0None<\/li>\n\n\n\n<li><strong>Execution environment pull policy:<\/strong>\u00a0tag<\/li>\n\n\n\n<li><strong>Execution environment pull needed:<\/strong>\u00a0True<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Updating the Execution Environment<\/h3>\n\n\n\n<p>When you launch Ansible Navigator for the first time, it runs the following command to pull the necessary image:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>docker pull ghcr.io\/ansible\/creator-ee:v0.22.0<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Step 6: List Available Images<\/h2>\n\n\n\n<p>Finally, you can list the available images by running:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>ansible-navigator images<\/code><\/pre>\n\n\n\n<p>The output will display details about the images, such as:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>  Image        Tag     Execution environment  Created       Size\n0\u2502creator-ee  v0.22.0 True                   8 months ago  999MB<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"<p>Ansible Navigator is an essential tool for managing Ansible automation more effectively. In this guide, I&#8217;ll walk you through the &hellip; <a href=\"https:\/\/robermb.com\/blog\/geeks\/how-to-install-ansible-navigator-on-macos\/\" class=\"more-link\">More <span class=\"screen-reader-text\">How to Install Ansible Navigator on macOS<\/span> <span class=\"meta-nav\">&rarr;<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":1806,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[103,2],"tags":[141,106,112,126],"_links":{"self":[{"href":"https:\/\/robermb.com\/blog\/wp-json\/wp\/v2\/posts\/2167"}],"collection":[{"href":"https:\/\/robermb.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/robermb.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/robermb.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/robermb.com\/blog\/wp-json\/wp\/v2\/comments?post=2167"}],"version-history":[{"count":3,"href":"https:\/\/robermb.com\/blog\/wp-json\/wp\/v2\/posts\/2167\/revisions"}],"predecessor-version":[{"id":2172,"href":"https:\/\/robermb.com\/blog\/wp-json\/wp\/v2\/posts\/2167\/revisions\/2172"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/robermb.com\/blog\/wp-json\/wp\/v2\/media\/1806"}],"wp:attachment":[{"href":"https:\/\/robermb.com\/blog\/wp-json\/wp\/v2\/media?parent=2167"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/robermb.com\/blog\/wp-json\/wp\/v2\/categories?post=2167"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/robermb.com\/blog\/wp-json\/wp\/v2\/tags?post=2167"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}