Mousehat

This project aims at setting up a your computer in an automated fashion. This started in for just linux but now has evolved into a solution for Windows WSL, MacOs and Linux. In all the solutions it has support for docker based applications and can support GUI Docker images.

Linux Supprt: Debian/Ubuntu/Arch Linux, Support GNOME 3/i3 desktop Windows WSL: Tested with Ubuntu WSL 2 MacOS: Mojave

Getting Started

These instructions will get you a copy of the project up and running on your local machine. The project contains a /testvm directory that will help you setup this project for testing and/or working out of a virtualbox vm.

Requirements - Linux/WSL 2

1. su to root
2. Install sudo `apt-get install sudo
3. Install ansible apt-get install ansible
4. Install git apt-get install git
5. Add your user to sudo group usermod -aG sudo username
6. Add your user to /etc/sudoers to make it so they don't have a pasword to sudo. Add the following username ALL=(ALL) NOPASSWD: ALL
7. You will need to install ansible > 2.7. On debian the default repo has an older version of ansible that will not work with the custom_role feature. If you want this feature you will need to install a newer feature. I tested it on 2.7.9.

Requirements - MacOS

1. Install brew /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. Install ansible brew install ansible
3. If you are running on a M series chip run softwareupdate --install-rosetta to allow backward comptability to intel
4. su to root sudo su
5. Add your user to /etc/sudoers to make it so they don't have a pasword to sudo. Add the following username ALL=(ALL) NOPASSWD: ALL

vmware

1. install vmware tools: sudo apt-get install open-vm-tools
2. install vmsare tools desktop: sudo apt-get install open-vm-tools-desktop
3. reboot

Install

1. git clone this repo: git clone https://github.com/gschaetz/mousehat.git
2. Use the built in settings to start or build your own off of mousehat/ansible/desktop-ansible/settings
3. Run the desktop setup config. If you want to supply your own application setting files use the -s flag.
   For Non-WSL:

./runplay.sh

./runplay.sh -s /mysettings

For WSL:

./runplay.sh -w

./runplay.sh -s /mysettings -w

1. if you use my settings the ansible repo setup will have to ran twice. The first time will fail. Ignore and re-run.
2. Again if you are running mine the ansible will fail on the custom role. After it runs do the following: sudo apt-get upgrade ansible. Then rerun the ansible.
3. reboot the machine to see all the changes and start docker

Built With

• Ansible - The automation framework used

License

This project is licensed under the MIT License - see the LICENSE.MD file for details