Ansible collection: foundata.fail2ban

This repository contains the foundata.fail2ban Ansible Collection. It provides resources to manage fail2ban, a daemon to ban hosts that cause multiple authentication errors.

⭐ Found this useful? Support open-source and star this project:

Table of contents

• Included content
• Dependencies
• Versioning and deprecation
• Licensing, copyright
• Author information

Included content

Role: foundata.fail2ban.run

The primary role in this collection to configure and maintain Fail2Ban, including jail configuration, filters, actions, and related settings. Its README.md covers configuration and usage examples.

• Ansible role: foundata.fail2ban.run
  • Table of contents
  • Features
  • Example playbooks, using this role
  • Supported tags
  • Role variables
    • run_fail2ban_state
    • run_fail2ban_autoupgrade
    • run_fail2ban_service_state
    • run_fail2ban_service_settings
    • run_fail2ban_config_service_dropin_file_name
    • run_fail2ban_jail_settings
    • run_fail2ban_config_jail_dropin_file_name
    • run_fail2ban_custom_filters
    • run_fail2ban_custom_actions
  • Dependencies
  • Compatibility
  • External requirements

Dependencies

See dependencies in galaxy.yml.

Versioning and deprecation

This project follows Semantic Versioning. Patch releases contain compatible fixes; minor releases may add compatible features or deprecations. Breaking changes, including changes to public defaults or removal of supported runtimes, require a major release.

Deprecations are announced in the changelog and relevant documentation, with migration guidance and the planned removal version. Deprecated interfaces remain available until that major release.

Licensing, copyright

Copyright (c) 2026, foundata GmbH https://foundata.com

This project is licensed under the GNU General Public License v3.0 or later (SPDX-License-Identifier: GPL-3.0-or-later), see LICENSES/GPL-3.0-or-later.txt for the full text.

The REUSE.toml file provides detailed licensing and copyright information in a human- and machine-readable format. This includes parts that may be subject to different licensing or usage terms, such as third-party components. The repository conforms to the REUSE specification. You can use reuse spdx to create an SPDX software bill of materials (SBOM).

Trademarks

Third-party trademarks used in this repository:

• Ansible®, Fedora® and Red Hat® are trademarks of Red Hat, LLC, registered in the United States and other countries.
• Debian® is a trademark of Software in the Public Interest, Inc., registered in Germany and the United States.
• openSUSE® is a trademark of SUSE LLC or its affiliates, registered in the European Union and the United States.
• Ubuntu® is a trademark of Canonical Ltd., registered in Germany, the European Union and the United States.

Their use here is purely descriptive and does not imply any affiliation with or endorsement by the trademark holders.

Own and licensed trademarks used in this repository:

• foundata® is a trademark of IPAM GmbH, registered in Germany and the European Union, licensed to foundata GmbH.

Author information

This project was created and is maintained by foundata.