# [`ansible-playbook-desktop`][]
 
 An [Ansible][] [playbook][] for setting up a [desktop][] on [Debian][]-based
 [Linux distribution][]s.
 

 A [`Vagrantfile`][] is provided, try it out with the usual [`vagrant up`][].
 The [VirtualBox][] [Vagrant provider][] is configured to show the GUI. Some
 [Vagrant box][]es have a locked `vagrant` user, run `vagrant ssh -c 'echo
 vagrant:vagrant | sudo chpasswd'` to unlock and set the password to `vagrant`.
 After login, run `startx` to start the graphical environment.
 

 [`ansible-playbook-desktop`]: https://git.rcrnstn.net/rcrnstn/ansible-playbook-desktop
 [Ansible]: https://docs.ansible.com/ansible
 [playbook]: https://docs.ansible.com/ansible/latest/user_guide/playbooks.html
 [desktop]: https://en.wikipedia.org/wiki/Desktop_computer
 [Debian]: https://en.wikipedia.org/wiki/Debian
 [Linux distribution]: https://en.wikipedia.org/wiki/Linux_distribution

 [`Vagrantfile`]: https://www.vagrantup.com/docs/vagrantfile
 [`vagrant up`]: https://www.vagrantup.com/docs/cli/up.html
 [VirtualBox]: https://en.wikipedia.org/wiki/VirtualBox
 [Vagrant provider]: https://www.vagrantup.com/docs/providers
 [Vagrant box]: https://www.vagrantup.com/docs/boxes

 ## Requirements
 
 [Collection][]s:
 
 -   [`community.general`][]
 
 [Role][]s:
 
 -   [`ansible-role-xsession`][]
 -   [`ansible-role-xwinwrap`][]
 -   [`ansible-role-dotfiles`][]
 -   [`ansible-role-firefox-extensions`][]
 
 Make sure requirements are satisfied by running
 
 ```
 ansible-galaxy install -f -r requirements.yml
 ```
 
 [collection]: https://docs.ansible.com/ansible/latest/user_guide/collections_using.html
 [`community.general`]: https://docs.ansible.com/ansible/latest/collections/community/general/index.html
 [role]: https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html
 [`ansible-role-xsession`]: https://git.rcrnstn.net/rcrnstn/ansible-role-xsession
 [`ansible-role-xwinwrap`]: https://git.rcrnstn.net/rcrnstn/ansible-role-xwinwrap
 [`ansible-role-dotfiles`]: https://git.rcrnstn.net/rcrnstn/ansible-role-dotfiles
 [`ansible-role-firefox-extensions`]: https://git.rcrnstn.net/rcrnstn/ansible-role-firefox-extensions
 
 ## Usage
 
 Run
 
 ```
 ansible-playbook -K -i $host, desktop.yml
 ```
 
 (note the comma!) replacing `$host` with the host you want to set up (can be
 `localhost`, perhaps adding `--connection=local`).
 

 ## License
 
 Licensed under the [ISC License][] unless otherwise noted, see the
 [`LICENSE`][] file.
 
 [ISC License]: https://choosealicense.com/licenses/isc/
 [`LICENSE`]: LICENSE