# Ansible Configuration

Configure how Atmos executes Ansible commands for configuration management and
infrastructure automation, including playbook execution and inventory
management.

## Configuration

**File:** `atmos.yaml`

```yaml
components:
  ansible:
    # Executable to run
    command: ansible

    # Base path to Ansible components
    base_path: components/ansible
```

## Configuration Reference

- **`command`**

  Specifies the executable to run for Ansible commands. Defaults to `ansible`.

  Examples:
  - `ansible` - Use Ansible from PATH
  - `/usr/local/bin/ansible` - Use specific binary
  - `/opt/venv/bin/ansible` - Use virtualenv binary
- **`base_path`**

  Directory containing Ansible component directories. Supports absolute and relative paths.

  Each subdirectory should contain Ansible playbooks and related files (roles, inventory, etc.).

## Component Directory Structure

Ansible components follow the same directory structure as other component types:

```

components/
└── ansible/
├── hello-world/
│ ├── site.yml
│ └── inventory.ini
└── webserver/
├── site.yml
├── roles/
└── inventory/

```

## Usage

With this configuration, you can run Ansible commands through Atmos:

```bash
# Run a playbook
atmos ansible playbook hello-world -s dev

# Check Ansible version
atmos ansible version
```

## Related Commands

## Related

- [Component Configuration Overview](/cli/configuration/components)
- [Ansible Components](/stacks/components/ansible)
- [Stack Configuration](/cli/configuration/stacks)