A text-based user interface (TUI) for the Red Hat Ansible Automation Platform.
A demo of the interface can be found on youtube.
Getting started with ansible-navigator is as simple as:
pip install ansible-navigator ansible-navigator --help
(Users wishing to install within a virtual environment might find the relevant Python documentation useful.)
By default, ansible-navigator uses a container runtime (
whichever it finds first) and runs Ansible within an execution environment
(a pre-built container image which includes ansible-core along with a set
of Ansible collections).
This default behavior can be disabled by starting ansible-navigator with
--execution-environment false. In this case, Ansible and any collections
needed must be installed manually on the system.
ansible-navigator with no arguments, you will be presented with
the welcome page. From this page, you can run playbooks, browse collections,
explore inventories, read Ansible documentation, and more.
A full list of key bindings can be viewed by typing
There are two modes in which ansible-navigator can be run:
The interactive mode is the default and this default can be overwritten by
--mode stdout (
-m stdout) or setting
All of ansible-navigator's features can be accessed from the welcome page described above, but as a shortcut, commands can also be provided directly as command-line arguments.
ansible-navigator doc ansible.netcommon.cli_command
ansible-navigator inventory -i inventory.yaml
ansible-navigator run site.yaml -i inventory.yaml
Or, using the stdout mode described above:
ansible-navigator config dump -m stdout
ansible-navigator doc sudo -t become -m stdout
... and so on. A full list of subcommands and their relation to Ansible commands can be found in the subcommand documentation.
There are several ways to configure ansible-navigator and users and projects are free to choose the most convenient method for them. The full hierarchy of how various configuration sources are applied can be found in the FAQ mentioned below.
Of note, projects making use of ansible-navigator can include a project-wide configuration file with the project. If one is not found, ansible-navigator will look for a user-specific configuration file in the user's home directory. Details about this can be found in the settings documentation.
We maintain a list of common questions which provides a good resource to check if something is tripping you up. We also encourage additions to this document for the greater community!
ansible-navigator is released under the Apache License version 2. See the LICENSE file for more details.