BareTold help
BareTold runs your own Ansible from a Mac and shows what Ansible predicts and what it reported. It does not replace your playbooks or take over your servers.
Before you start
- macOS 14 or later, on Apple silicon.
- Your own ansible-core 2.19 or later, already working on your Mac.
- A project folder with your playbooks and inventory, and your usual access to the hosts you want to manage.
Your first check
- Open your project folder in BareTold. Review the trust prompt and setup checklist. Opening an unfamiliar folder runs nothing until you agree.
- Choose the playbook and named hosts you want to check.
- Press Check. BareTold runs a dry run and shows what Ansible predicts. Read the notes about steps it cannot predict. Some tasks can make real changes even during a dry run, so review your playbooks first.
- Review the changes, then choose Apply when you are ready. Apply re-runs the playbook. It cannot apply a saved plan, and the result may differ from the dry run.
During and after a run
- Stop now interrupts the run. A step may still have finished on the host. Check again to find out its current state.
- View raw log opens Ansible's own output, with secrets masked by BareTold.
- History shows runs made through BareTold. Changes made outside it are not recorded.
- Secrets are masked in BareTold's changes, raw log and history. Logs you keep outside the app may still contain secrets.
Keyboard shortcuts
- ⌘R: Check.
- ⌘⇧Return: Apply.
- ⌘.: Stop now.
- ⌘L: Raw log.
- ⌘F: Search history.
- ⌘D: Diff viewer.
- ⌘,: Settings.
More in the Guide
Need a hand?
Email [email protected] with your BareTold version, macOS version and what you expected to happen. Review anything you copy before sending it. Never send credentials, unredacted inventories or secret values.
Beta opens soon