2013-09-03 18:08:28 +00:00
|
|
|
---
|
2013-09-06 16:08:09 +00:00
|
|
|
page_title: "Backwards Compatibility"
|
2013-09-03 18:08:28 +00:00
|
|
|
sidebar_current: "installation-backwards-compatibility"
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Backwards Compatibility
|
|
|
|
|
|
|
|
|
|
## For 1.0.x
|
|
|
|
|
|
|
|
|
|
Vagrant 1.1+ provides full backwards compatibility for valid Vagrant 1.0.x
|
|
|
|
|
Vagrantfiles which don't use plugins. After installing Vagrant 1.1, your 1.0.x environments should
|
|
|
|
|
continue working without modifications, and existing running machines will
|
|
|
|
|
continue to be managed properly.
|
|
|
|
|
|
2013-11-23 22:14:01 +00:00
|
|
|
This compatibility layer will remain in Vagrant up to and including Vagrant 2.0.
|
|
|
|
|
It may still exist after that, but Vagrant's compatibility promise is only for
|
|
|
|
|
two versions. Seeing that major Vagrant releases take years to develop and
|
|
|
|
|
release, it is safe to stick with your version 1.0.x Vagrantfile for the
|
|
|
|
|
time being.
|
|
|
|
|
|
2013-09-03 18:08:28 +00:00
|
|
|
If you use any Vagrant 1.0.x plugins, you must remove references to these from
|
|
|
|
|
your Vagrantfile prior to upgrading. Vagrant 1.1+ introduces a new plugin
|
|
|
|
|
format that will protect against this sort of incompatibility from ever
|
|
|
|
|
happening again.
|
|
|
|
|
|
|
|
|
|
If your Vagrantfile doesn't just work with 1.1 and doesn't use any plugins,
|
|
|
|
|
please [report a bug](https://github.com/mitchellh/vagrant/issues).
|
|
|
|
|
|
|
|
|
|
## For 1.x
|
|
|
|
|
|
|
|
|
|
Backwards compatibility between 1.x is not promised, and Vagrantfile
|
|
|
|
|
syntax stability isn't promised until 2.0 final. Any backwards incompatibilities
|
|
|
|
|
within 1.x will be clearly documented.
|
|
|
|
|
|
|
|
|
|
This is similar to how Vagrant 0.x was handled. In practice, Vagrant 0.x
|
|
|
|
|
only introduced a handful of backwards incompatibilities during the entire
|
|
|
|
|
development cycle, but the possibility of backwards incompatibilities
|
|
|
|
|
is made clear so people aren't surprised.
|
|
|
|
|
|
|
|
|
|
Vagrant 2.0 final will have a stable Vagrantfile format that will
|
|
|
|
|
remain backwards compatible, just as 1.0 is considered stable.
|
