Skip to main content

A text-based user interface (TUI) for the Red Hat Ansible Automation Platform

Project description

ansible-navigator

A text-based user interface (TUI) for Ansible.

A demo of the interface can be found on YouTube.

Communication

Refer to the Talk to us section of the Contributing guide to find out how to get in touch with us.

You can also find more information in the Ansible communication guide.

Contributing

Any kind of contribution to this project is very welcome and appreciated, whether it is a documentation improvement, bug report, pull request review, or a patch.

See the Contributing guidelines for details.

Code of Conduct

Please see the official Ansible Community Code of Conduct.

Quick start

Installing

Getting started with ansible-navigator is as simple as:

pip3 install 'ansible-navigator[ansible-core]'
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 (podman or docker, 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.

Additional Linux, macOS and Windows with WSL2 installation instructions are available in the Installation guide.

Welcome

When running 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 :help.

Output modes

There are two modes in which ansible-navigator can be run:

  • The interactive mode, which provides a curses-based user interface and allows you to "zoom in" on data in real time, filter it, and navigate between various Ansible components; and
  • The stdout mode, which does not use curses, and simply returns the output to the terminal's standard output stream, as Ansible's commands would.

The interactive mode is the default and this default can be overwritten by passing --mode stdout (-m stdout) or setting mode in configuration.

Example commands

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.

Some examples:

  • Review and explore available collections: ansible-navigator collections
  • Review and explore current Ansible configuration: ansible-navigator config
  • Review and explore Ansible documentation: ansible-navigator doc ansible.netcommon.cli_command
  • Review execution environment images available locally: ansible-navigator images
  • Review and explore an inventory: ansible-navigator inventory -i inventory.yaml
  • Run and explore a playbook: ansible-navigator run site.yaml -i inventory.yaml

Or using the stdout mode described above:

  • Show the current Ansible configuration: ansible-navigator config dump -m stdout
  • Show documentation: 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.

Configuring ansible-navigator

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.

Frequently Asked Questions (FAQ)

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!

License

ansible-navigator is released under the Apache License version 2. See the LICENSE file for more details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ansible_navigator-25.5.0.tar.gz (394.2 kB view details)

Uploaded Source

Built Distribution

ansible_navigator-25.5.0-py3-none-any.whl (304.3 kB view details)

Uploaded Python 3

File details

Details for the file ansible_navigator-25.5.0.tar.gz.

File metadata

  • Download URL: ansible_navigator-25.5.0.tar.gz
  • Upload date:
  • Size: 394.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for ansible_navigator-25.5.0.tar.gz
Algorithm Hash digest
SHA256 7c616ed4099c148ccc50bfebed2bcaee3b2c9134226a74ba632eb1b9b35d98d9
MD5 06fe2d5bb66b67932f3712c612f4f952
BLAKE2b-256 fc12a34f8457bc3b33e0b393770b287f276f8aa249511d8172d0c10edccf23cf

See more details on using hashes here.

Provenance

The following attestation bundles were made for ansible_navigator-25.5.0.tar.gz:

Publisher: release.yml on ansible/ansible-navigator

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ansible_navigator-25.5.0-py3-none-any.whl.

File metadata

File hashes

Hashes for ansible_navigator-25.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e67f1763fe75428e54087e446206ca053096a4d05e34c32a9798558e7cb6cef9
MD5 944f2aa6e401cb0f2e5bbb2a2a77824b
BLAKE2b-256 e49c336c1bdf811a2d6ab4b77777b668db843d10bd141e9d250570c84822ab59

See more details on using hashes here.

Provenance

The following attestation bundles were made for ansible_navigator-25.5.0-py3-none-any.whl:

Publisher: release.yml on ansible/ansible-navigator

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page