vagrant/website/docs/source/v2/push/index.html.md

page_title	sidebar_current	description
Vagrant Push	push	Vagrant Push is a revolutionary

Vagrant Push

As of version 1.8, Vagrant is capable of deploying or "pushing" application code running as part of the Vagrant VM to a remote such as an FTP server or HashiCorp's Atlas.

Pushes are defined in an application's Vagrantfile and are invoked using the vagrant push subcommand. Much like other components of Vagrant, each Vagrant Push plugin has its own configuration options. Please consult the documentation for your Vagrant Push plugin for more information. Here is an example Vagrant Push configuration section in a Vagrantfile:

config.push.define "ftp" do |push|
  push.host = "ftp.company.com"
  push.username = "..."
  # ...
end

When the application is ready to be deployed to the FTP server, just run a single command:

$ vagrant push

Much like Vagrant Providers, Vagrant Push also supports multiple backend declarations. Consider the common scenario of a staging and QA environment:

config.push.define "staging", strategy: "ftp" do |push|
  # ...
end

config.push.define "qa", strategy: "ftp" do |push|
  # ...
end

In this scenario, the user must pass the name of the Vagrant Push to the subcommand:

$ vagrant push staging

Vagrant Push is the easiest way to deploy your application. You can read more in the documentation links on the sidebar.