stiliajohny / vagrant-dev-box Goto Github PK

Quick and easy Development Box build with Ansible and Vagrant
Explore the docs »
Report Bug · Request Feature

• Table of Contents
• About The Project
  • Built With
• Getting Started
  • Prerequisites
  • Installation
• Usage
  • Web accesible apps
  • i3-wm keybinds
• Roadmap
• Contributing
• License
• Contact
• Acknowledgements

I always wanted to have a quick way to build a VM that contains all of my favorite tools and configs. Here is my take on a Dev Box build with Ansible and Vagrant.

Use it carefully.

• Vagrant
• Ruby
• Ansible

• Ansible
• Vagrant
• VirtualBox ( My preferred way for Virtualization )

• Ansible Official Installation guide
• Vagrant Official Installation guide
• VirtualBox ( My preferred way for Virtualization ) Official Installation guide

• Git Clone the repo
• cd in the cloned repo
• Run
  • vagrant up VM_NAME to start and provision the instance
  • vagrant provision VM_NAME to re-provision the instance
  • vagrant pause VM_NAME to pause the instance
  • vagrant resume VM_NAME to resume a previously paused instance
  • vagrant destroy VM_NAME to completely destroy the instance
  • vagrant ssh VM_NAME to ssh in the instance
  • vagrant global-status to get all the running instances ID
  • vagrant ssh 123abc to ssh in the specific instance via the ID gathered earlier

If no VM_NAME is given the default VM_NAME is Archlinux-Vagrant

Multiple VMs can be created if different VM_NAMES are given.

• VNC on browser ( Xorg Display ) - http://localhost:6081/vnc.html
• VNC on browser ( Virt Display ) - http://localhost:6081/vnc.html
• VSCode on browser - http://localhost:8080

• Ctrl - Mod key
• Ctrl+d - rofi menu

See the open issues for a list of proposed features (and known issues).

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Distributed under the GPL-3.0 License. See LICENSE for more information.

John Stilia - @john_stilia - [email protected]

• GitHub Emoji Cheat Sheet
• Img Shields
• Choose an Open Source License
• GitHub Pages