README.md

Vagrant Dev Box

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

Table of Contents

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

About The Project

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.

Built With

• Vagrant
• Ruby
• Ansible

---

Getting Started

Prerequisites

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

Installation

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

---

Usage

• Git Clone the repo
• cd in the cloned repo
• Run
  • vagrant up to start and provision the instance
  • vagrant provision to re-provision the instance
  • vagrant pause to pause the instance
  • vagrant resume to resume a previously paused instance
  • vagrant destroy to completely destroy the instance
  • vagrant ssh 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

Web accesible apps

• 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

i3-wm keybinds

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

---

Roadmap

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

---

Contributing

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

---

License

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

Contact

John Stilia - @john_stilia - stilia.johny@gmail.com

---

Acknowledgements

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