Role Detail


Dotfile installation for UNIX/Linux.
Type Ansible
Minimum Ansible Version 2.2
Installation $ ansible-galaxy install geerlingguy.dotfiles
Last Commit 2017-04-12 15:42:03 PM UTC
Last Imported 2017-05-15 02:55:02 AM UTC
Version History
Version Release Date
1.1.0 2016-06-14 20:19:08 PM
1.0.0 2015-01-03 05:04:05 AM
Supported Platforms
Platform Version
GenericBSD any
GenericLinux any
GenericUNIX any
Last 10 Imports
Completed Status
2017-05-15 02:55:02 AM UTC SUCCESS
2017-05-08 15:09:03 PM UTC SUCCESS
2017-05-08 15:08:03 PM UTC SUCCESS
2017-04-12 16:08:04 PM UTC SUCCESS
2017-04-12 15:44:03 PM UTC SUCCESS
2017-04-02 04:04:04 AM UTC SUCCESS
2017-01-22 02:23:02 AM UTC SUCCESS
2017-01-08 23:17:11 PM UTC SUCCESS
2016-11-23 15:21:03 PM UTC SUCCESS
2016-11-02 20:20:08 PM UTC SUCCESS

Ansible Role: Dotfiles

Build Status

Installs a set of dotfiles from a given Git repository. By default, it will install my (geerlingguy's) dotfiles, but you can use any set of dotfiles you'd like, as long as they follow a conventional format.


Requires git on the managed machine (you can easily install it with geerlingguy.git if required).

Role Variables

Available variables are listed below, along with default values (see defaults/main.yml):

dotfiles_repo: ""

The git repository to use for retrieving dotfiles. Dotfiles should generally be laid out within the root directory of the repository.

dotfiles_repo_accept_hostkey: no

Add the hostkey for the repo url if not already added. If ssh_opts contains "-o StrictHostKeyChecking=no", this parameter is ignored.

dotfiles_repo_local_destination: "~/Documents/dotfiles"

The local path where the dotfiles_repo will be cloned.

dotfiles_home: "~"

The home directory where dotfiles will be linked. Generally, the default should work, but in some circumstances, or when running the role as sudo on behalf of another user, you may want to specify the full path.

  - .bash_profile
  - .gitignore
  - .inputrc
  - .vimrc

Which files from the dotfiles repository should be linked to the dotfiles_home.



Example Playbook

- hosts: localhost
    - { role: geerlingguy.dotfiles }



Author Information

This role was created in 2015 by Jeff Geerling, author of Ansible for DevOps.