AnsibleByExample

Fix Ansible "Skipping: No Hosts Matched" — Why Your Playbook Runs on Zero Hosts

beginnerAnsible ErrorAnsible TroubleshootingAnsible InventoryAnsible for Beginners
2026-03-032By Luca Berton

Lesson 1 of 20 in Production Playbooks

Production Playbooks and Troubleshooting — full curriculum
  1. 1. Advanced Playbook Structure & Execution Strategies
  2. 2. Deep Dive: Variable Precedence & Best Practices
  3. 3. Jinja2 Templating Beyond Basics
  4. 4. Advanced Conditionals
  5. 5. Loops Masterclass
  6. 6. Blocks, Rescue, Always (Error Handling)
  7. 7. Handlers Advanced
  8. 8. Change Control: changed_when, failed_when
  9. 9. Tags and Selective Runs
  10. 10. Performance Tuning
  11. 11. Delegation Patterns
  12. 12. Local Actions and Remote Actions
  13. 13. Dynamic Inventory & Runtime Host Management
  14. 14. Includes & Imports (Structuring Large Codebases)
  15. 15. Role Design Patterns
  16. 16. Ansible Galaxy & Collections in Real Projects
  17. 17. Working with APIs (uri + JSON workflows)
  18. 18. Testing and Linting (Quality Gates)
  19. 19. Advanced Debugging Playbook Failures
  20. 20. Capstone: Multi-Stage Deployment
View path overview →

The Warning

[WARNING]: Could not match supplied host pattern, ignoring: webservers
skipping: no hosts matched

Your playbook runs but does absolutely nothing. Here's why and how to fix it.

Cause 1: Typo in hosts or Group Name

# playbook.yml
- hosts: websevers  # ← typo! should be "webservers"
  tasks:
    - name: Ping
      ansible.builtin.ping:

# inventory
[webservers]  # ← correct spelling
web1 ansible_host=192.168.1.10

Fix: Double-check spelling in both playbook hosts: and inventory group names.

Cause 2: Wrong Inventory File

# Using default /etc/ansible/hosts but your hosts are elsewhere
ansible-playbook playbook.yml

# Fix: specify inventory
ansible-playbook -i inventory/production playbook.yml

Or set it in ansible.cfg:

[defaults]
inventory = ./inventory/hosts

Cause 3: Host Pattern Mismatch

# This only matches hosts IN the group "webservers"
- hosts: webservers

# This matches the literal hostname "webservers"
- hosts: webservers

Verify your inventory:

# List all hosts in a group
ansible webservers --list-hosts -i inventory

# List all groups
ansible-inventory -i inventory --graph

Cause 4: Limit Flag Filtering Everything Out

# This limits to only "db1" — webservers won't run
ansible-playbook playbook.yml --limit db1

Cause 5: Dynamic Inventory Returns Empty

# Test your dynamic inventory script
./inventory.py --list | python3 -m json.tool

Quick Fix Checklist

  1. ansible-inventory --graph — see what Ansible actually knows about
  2. Check hosts: in playbook matches a group or host name exactly
  3. Verify inventory file path with -i
  4. Remove --limit flags temporarily
  5. Check for YAML indentation issues in inventory

Conclusion

"No hosts matched" almost always means Ansible can't find the hosts you specified. Verify your inventory path, check for typos, and use ansible-inventory --graph to see what's actually loaded.

All Tutorials