https://github.com/petemcw/ansible-role-dotfiles

Ansible role for creating consistent user environment
https://github.com/petemcw/ansible-role-dotfiles

ansible ansible-role dotfiles

Last synced: 3 months ago
JSON representation

Ansible role for creating consistent user environment

• Host: GitHub
• URL: https://github.com/petemcw/ansible-role-dotfiles
• Owner: petemcw
• License: mit
• Created: 2014-10-20T19:55:14.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2014-10-20T19:55:29.000Z (over 11 years ago)
• Last Synced: 2025-07-25T22:47:50.001Z (12 months ago)
• Topics: ansible, ansible-role, dotfiles
• Size: 97.7 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Dotfiles Role for Ansible

This role installs an opinionated version of [dotfiles](http://dotfiles.github.io/)

that we use on our servers.

## Requirements

This role requires [Ansible](http://www.ansibleworks.com/) version 1.4 or higher

and the Debian/Ubuntu platform.

## Role Variables

The variables that can be passed to this role and a brief description about

them are as follows:

```yaml

# The name of the user to configure

dotfiles_user: 'admin'

# The user's preferred home directory

dotfiles_home_dir: '/home/admin'

# The user's preferred shell

dotfiles_shell: '/bin/zsh'

```

## Examples

1. Install dotfiles for "admin" user with default shell

    ```yaml

    ---

    # This playbook installs dotfiles

    - name: Apply dotfiles to all nodes

      hosts: all

      roles:

        - { role: dotfiles,

            dotfiles_user: 'admin',

            dotfiles_home_dir: '/home/admin'

          }

    ```

## Dependencies

The following packages may be required for Debian derivatives:

- `git-core`

## License

MIT.