# RancherOS Vagrant

Quickly checkout RancherOS using Vagrant/Virtualbox.


## Getting started
1.) Install dependencies

* Virtualbox (Tested with 4.3.22)
* Vagrant (Tested with 1.7.2)

2.) Clone this project

```
git clone https://github.com/rancherio/os-vagrant.git
cd os-vagrant
```

3.) Up and Running

```
vagrant up
vagrant ssh
```

Start running Docker like you usually would!

## Enable Rsync folder sync
If you want to sync the current working directory via rsync edit the Vagrantfile and change this line:

<pre>$rsync_folder_disabled = true</pre>

to

<pre>
$rsync_folder_disabled = <b>false</b>
</pre>
## Upgrading RancherOS Versions

To upgrade the Vagrant box, refresh this repository from master.

```
vagrant destroy
vagrant box remove rancheros
vagrant up
```


### Customizing and configuring


To get a feel for how things work under the hood checkout the 
[RancherOS Repo](https://github.com/rancherio/os) for details.

## Contact
For bugs, questions, comments, corrections, suggestions, etc., open an issue in
 [rancherio/os](//github.com/rancherio/os/issues) with a title starting with `[os-vagrant] `.

Or just [click here](//github.com/rancherio/os/issues/new?title=%5Bos-vagrant%5D%20) to create a new issue.


# License
Copyright (c) 2014-2015 [Rancher Labs, Inc.](http://rancher.com)

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.