64 lines
2.5 KiB
Markdown
64 lines
2.5 KiB
Markdown
---
|
|
layout: "intro"
|
|
page_title: "Share - Getting Started"
|
|
sidebar_current: "gettingstarted-share"
|
|
description: |-
|
|
Now that we have a web server up and running and accessible from your machine,
|
|
we have a fairly functional development environment. But in addition to
|
|
providing a development environment, Vagrant also makes it easy to share
|
|
and collaborate on these environments. The primary feature to do this in
|
|
Vagrant is called Vagrant Share.
|
|
---
|
|
|
|
# Share
|
|
|
|
Now that we have a web server up and running and accessible from your machine,
|
|
we have a fairly functional development environment. But in addition to
|
|
providing a development environment, Vagrant also makes it easy to share
|
|
and collaborate on these environments. The primary feature to do this in
|
|
Vagrant is called [Vagrant Share](/docs/share/).
|
|
|
|
Vagrant Share lets you share your Vagrant environment to anyone around the
|
|
world with an Internet connection. It will give you a URL that will route
|
|
directly to your Vagrant environment from any device in the world that is
|
|
connected to the Internet.
|
|
|
|
First, follow the [installation guide](/docs/share/#installation) before getting
|
|
started. You need the `vagrant-share` plugin for the rest of the tutorial to work.
|
|
|
|
Next, run `vagrant share`:
|
|
|
|
```
|
|
$ vagrant share
|
|
...
|
|
==> default: Creating Vagrant Share session...
|
|
==> default: HTTP URL: http://b1fb1f3f.ngrok.io
|
|
...
|
|
```
|
|
|
|
Your URL will be different, so do not try the URL above. Instead, copy
|
|
the URL that `vagrant share` outputted for you and visit that in a web
|
|
browser. It should load the Apache page we setup earlier.
|
|
|
|
If you modify the files in your shared folder and refresh the URL, you will
|
|
see it update! The URL is routing directly into your Vagrant environment,
|
|
and works from any device in the world that is connected to the internet.
|
|
|
|
To end the sharing session, hit `Ctrl+C` in your terminal. You can refresh
|
|
the URL again to verify that your environment is no longer being shared.
|
|
|
|
Vagrant Share is much more powerful than simply HTTP sharing. For more
|
|
details, see the [complete Vagrant Share documentation](/docs/share/).
|
|
|
|
Note: Vagrant Share now defaults to using the `ngrok` driver.
|
|
The `classic` driver has been deprecated.
|
|
|
|
~> **Vagrant share is not designed to serve production traffic!** Please do not
|
|
rely on Vagrant share outside of development or Q/A. The Vagrant share service
|
|
is not designed to carry production-level traffic.
|
|
|
|
## Next Steps
|
|
|
|
You have successfully shared your environment with the world. Congratulations!
|
|
Read on to learn about the [teardown process](/intro/getting-started/teardown.html).
|