From 7b6b37848ff8c76e8694f98f1151dcf0965644c8 Mon Sep 17 00:00:00 2001 From: Webster Mudge Date: Thu, 21 Dec 2023 12:24:38 -0500 Subject: [PATCH] Add warning for OSX stock Python (#73) Signed-off-by: Webster Mudge --- NAVIGATOR.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/NAVIGATOR.md b/NAVIGATOR.md index d17c3fa..c87c273 100644 --- a/NAVIGATOR.md +++ b/NAVIGATOR.md @@ -25,6 +25,9 @@ Setting up `ansible-navigator` is easy; you can spin up a new setup in **TWO** s pip install ansible-core ansible-navigator ``` +> [!WARNING] +> On OSX, avoid using the stock Python executable with `ansible-navigator`; users report that the `curses` library in the stock installation is unable to run (throws a segfault). You might want to install a non-stock version of Python, such as using Homebrew or similar. + # Usage `ansible-navigator` can be viewed as a wrapper around the core Ansible application, like `ansible-playbook`, `ansible-galaxy`, `ansible-doc`, etc. Read more about how to [configure](https://ansible.readthedocs.io/projects/navigator/settings/) your setup and your project execution as well as the [mapping](https://ansible.readthedocs.io/projects/navigator/subcommands/#mapping-ansible-navigator-commands-to-ansible-commands) of and [running](https://ansible.readthedocs.io/projects/navigator/subcommands/) of these subcommands.