Introduction

This repository contains the Vagrant setup for the Redhouse box.

The Redhouse box is a Vagrant box setup to develop Ruby projects based on the Laravel Homestead project which fulfills that role for PHP projects.

The base box for this project is built with https://github.com/mrkcor/redhouse-packer

Many thanks to everyone who has contributed to Vagrant, Homestead and the related projects to make the lives of many developers a great deal easier!

Getting started

To get started simply copy the readhouse.yaml.sample file to readhouse.yaml and modify it to your liking. Once you're done editing run 'vagrant up' and wait for the provisioning to complete.

Once the provisioning is complete there will be a .pem file in the redhouse directory (generated through scripts/create-root-certificate.sh), if you install this in your browser as a trusted root certificate you will not get warnings for the certificates generated for the sites that you specified in redhouse.yaml.

MariaDB and PostgreSQL are installed, any databases mentioned in the 'databases' section of the redhouse.yaml file will be created for you in both of those. The database username is 'redhouse' and the password is 'overyonder'. For both you will need to connect to host 127.0.0.1 on the vagrant instance.

Running Rails projects

Define the shared folder, site and databases in redhouse.yaml:

folders:
  - map: ~/code/redhouse
    to: /home/vagrant/code/redhouse

sites:
  - map: redhouse.dev
    to: /home/vagrant/code/redhouse/public
    port: 3001
    ruby: 2.6.5

databases:
  - redhouse_development
  - redhouse_test

If you have already have a running box you can re-provision it with 'vagrant reload --provision'.

Once the vagrant box is up and running again you can ssh into it with 'vagrant ssh' and go to the directory to run the Rails project with 'bin/rails s -p 3001'. Provided that you added the domain in your local hosts file to point to the IP address of the vagrant box (also specified in redhouse.yaml) you can visit https://redhouse.dev to access your Rails project.

Q&A

Why the name Redhouse?

Rubies are red, Laravel named its Vagrant setup project Homestead which made me think of a house and that made me think of Jimi Hendrix's song "Red house"... which led to Redhouse.

Watchers on file changes are not picking changes on the shared folders. What gives?

Shared filesystems such as VirtualBox's shared folders only trigger filesystem events in the box when the files are changed there. I recently found https://github.com/mhallin/vagrant-notify-forwarder, that's a vagrant plugin that forwards filesystem events from the host to the guest and it seems to work pretty well for me so far.

How can I contribute?

Feel free to put an issue on GitHub issues and/or offer a pull request.