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 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.

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