Contents

# vagrant-disksize

A Vagrant plugin to resize disks in VirtualBox


## Installation


```shell
vagrant plugin install vagrant-disksize
```

## Usage

In your Vagrantfile

```ruby
config.disksize.size = '50GB'
```

## Limitations

At present only the first disk will be resized. That seems to be OK for
typical boxes such as the official Ubuntu images for Xenial, but there may
well be other configurations where the first disk found isn't the main HDD.

The plugin only works with VirtualBox but it will issue an error message
and then disable itself if you try to use it with another provider.

Disks can only be increased in size. There is no facility to shrink a disk.

Depending on the guest, you may need to resize the partition and the filesystem
from within the guest. At present the plugin only resizes the underlying disk.

This hasn't been tested on a wide variety of versions of Vagrant or VirtualBox.
It works for, at least, Vagrant 1.8.5 and VirtualBox 5.1.x, but any
feedback about other versions, particularly older ones, would be much appreciated.

## Development

After checking out the repo, run `bin/setup` to install dependencies.
You can also run `bin/console` for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run `bundle exec rake install`.
To release a new version, update the version number in `version.rb`, and then
run `bundle exec rake release`, which will create a git tag for the version,
push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).

## Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/sprotheroe/vagrant-disksize.

## License

The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
vagrant-disksize-0.1.1	README.md