52 lines
2.0 KiB
Markdown
52 lines
2.0 KiB
Markdown
---
|
|
layout: "docs"
|
|
page_title: "Vagrant Share"
|
|
sidebar_current: "share"
|
|
description: |-
|
|
Vagrant Share allows you to share your Vagrant environment with anyone in
|
|
the world, enabling collaboration directly in your Vagrant environment
|
|
in almost any network environment with just a single command- "vagrant share".
|
|
---
|
|
|
|
# Vagrant Share
|
|
|
|
Vagrant Share allows you to share your Vagrant environment with anyone in
|
|
the world, enabling collaboration directly in your Vagrant environment
|
|
in almost any network environment with just a single command:
|
|
`vagrant share`.
|
|
|
|
Vagrant share has three primary modes or features. These features are not
|
|
mutually exclusive, meaning that any combination of them can be active
|
|
at any given time:
|
|
|
|
* **HTTP sharing** will create a URL that you can give to anyone. This
|
|
URL will route directly into your Vagrant environment. The person using
|
|
this URL does not need Vagrant installed, so it can be shared with anyone.
|
|
This is useful for testing webhooks or showing your work to clients,
|
|
teammates, managers, etc.
|
|
|
|
* **SSH sharing** will allow instant SSH access to your Vagrant environment
|
|
by anyone by running `vagrant connect --ssh` on the remote side. This
|
|
is useful for pair programming, debugging ops problems, etc.
|
|
|
|
* **General sharing** allows anyone to access any exposed port of your
|
|
Vagrant environment by running `vagrant connect` on the remote side.
|
|
This is useful if the remote side wants to access your Vagrant
|
|
environment as if it were a computer on the LAN.
|
|
|
|
The details of each are covered in their specific section in the sidebar
|
|
to the left. We also have a section where we go into detail about the
|
|
security implications of this feature.
|
|
|
|
## Installation
|
|
|
|
Vagrant Share is a Vagrant plugin that must be installed. It is not
|
|
included with Vagrant system packages. To install the Vagrant Share
|
|
plugin, run the following command:
|
|
|
|
```shell
|
|
$ vagrant plugin install vagrant-share
|
|
```
|
|
|
|
Vagrant Share requires [ngrok](https://ngrok.com) to be used.
|