Lair is a Platform as a Service provider that you can install on your server or development machine with a single command.
Lair lets you get your latest code up and running with a simple git push
, and even includes a realtime activity monitor, so you can see what's going on under the hood, from the comfort of your browser.
Basically, Lair is your own personal Heroku-in-a-box.
- Git powered deployments with dokku
- Buildpack support via buildstep
- Real-time server statistics with scout_realtime
- Painless updates through git and puppet
There are three ways to install Lair:
- You can use the
bootstrap.sh
script to install Lair on a server with a single command - You can install Lair locally with Vagrant to try it out without needing a server, or to test your apps on your local machine
- You can install Lair manually using puppet-apply
Each of these methods is explained below
Before installing Lair on your server, make sure your server environment is supported. Lair is built and tested using an Ubuntu 12.04.4 x64 DigitalOcean Droplet, but it should work on any server provided you're running a fresh copy of Ubuntu 13.04 or 12.04 x64 (13.10 is not supported due to a known issue with docker).
To install Lair, ssh into your server and run the installer:
curl -s https://raw.github.com/qrohlf/lair/master/bootstrap.sh | sudo DOMAIN='yourdomain.com' bash
Once Lair finishes installing, head over to http://yourdomain.com to deploy your first app!
First, make sure you have Vagrant and Virtualbox installed on your machine.
Then, clone the repo and start Vagrant:
git clone https://github.com/qrohlf/lair.git
cd lair
vagrant up
Once Lair finishes installing, head over to http://lair.local to deploy your first app!
Lair is really just a collection of Puppet scripts and modules, so it should be really easy to get it working on any machine that has puppet installed.
Assuming you have Puppet already installed, all you need to do to get Lair up and running is:
export DOMAIN='yourdomain.com'
git clone https://github.com/qrohlf/lair
cd lair
./set-fqdn.sh $DOMAIN
FACTER_fqdn="$DOMAIN" puppet apply --modulepath modules --manifestdir manifests manifests/site.pp
Once Lair finishes installing, head over to http://yourdomain.com to deploy your first app!
You'll need to add an ssh key to Lair for each machine you want to deploy from. You'll only need to run this command once per machine.
(note: run this on your development machine - not on the server)
cat ~/.ssh/id_rsa.pub |ssh you@yourdomain.com "sudo sshcommand acl-add dokku '$USER@$HOSTNAME'"
If you're using Lair locally with Vagrant, run this command instead:
cat ~/.ssh/id_rsa.pub |ssh -i ~/.vagrant.d/insecure_private_key -p 2222 vagrant@localhost "sudo sshcommand acl-add dokku '$USER@$HOSTNAME'"
First, add a git remote pointing to Lair (this only needs to be done once per repo). Replace yourdomain.com
with your domain, or lair.local
if you're running Lair locally.
git remote add lair dokku@yourdomain.com:subdomain
Then, whenever you have changes to deploy just push them to the lair remote:
# make some changes to your app
git commit -m "awesome new feature"
git push lair master
# that's it!
Lair is actually just a bundle that brings together several excellent tools into one environment. The following people and tools do most of the heavy lifting:
- progrium/dokku handles application building and deployment
- scout/scout_realtime provides the nice activity monitor
- Vagrant handles VM creation and management
- Puppet is the glue that holds it all together
- I also was inspired by Vagrantpress and used their puppet scripts as a reference while I was writing some of the modules used in Lair.
See the Lair Wiki for help with troubleshooting.
Pull requests are welcome! Fork Lair on Github