new file mode 100644

@@ -0,0 +1,2 @@

+/.vagrant

+/*-console.log

@@ -3,12 +3,23 @@

 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

 ## License

new file mode 100644

@@ -0,0 +1,13 @@

+Vagrant.configure(2) do |config|

+  config.vm.box = 'debian/bullseye64' # Debian 11

+  # config.vm.box = 'ubuntu/jammy64'    # Ubuntu 22.04 LTS

+

+  config.vm.provider 'virtualbox' do |v|

+    v.gui = true

+  end

+

+  config.vm.provision 'ansible' do |ansible|

+    ansible.compatibility_mode = '2.0'

+    ansible.playbook = 'desktop.yml'

+  end

+end