known_hosts – Add or remove a host from the known_hosts file¶
Synopsis¶
- The known_hostsmodule lets you add or remove a host keys from theknown_hostsfile.
- Starting at Ansible 2.2, multiple entries per host are allowed, but only one for each key type supported by ssh. This is useful if you’re going to want to use the git module over ssh, for example.
- If you have a very large number of host keys to manage, you will find the template module more useful.
Parameters¶
Examples¶
- name: tell the host about our servers it might want to ssh to
  known_hosts:
    path: /etc/ssh/ssh_known_hosts
    name: foo.com.invalid
    key: "{{ lookup('file', 'pubkeys/foo.com.invalid') }}"
- name: Another way to call known_hosts
  known_hosts:
    name: host1.example.com   # or 10.9.8.77
    key: host1.example.com,10.9.8.77 ssh-rsa ASDeararAIUHI324324  # some key gibberish
    path: /etc/ssh/ssh_known_hosts
    state: present
Status¶
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors¶
- Matthew Vernon (@mcv21)
Hint
If you notice any issues in this documentation, you can edit this document to improve it.
