vagrant/website/source/docs/cli/share.html.md

50 lines
1.8 KiB
Markdown

---
layout: "docs"
page_title: "vagrant share - Command-Line Interface"
sidebar_current: "cli-share"
description: |-
The "vagrant share" command initializes a new Vagrant share session, which
allows you to share your virtual machine with the public Internet.
---
# Share
**Command: `vagrant share`**
The share command initializes a Vagrant Share session, allowing you to
share your Vagrant environment with anyone in the world, enabling collaboration
directly in your Vagrant environment in almost any network environment.
You can learn about all the details of Vagrant Share in the
[Vagrant Share section](/docs/share/).
The reference of available command-line flags to this command
is available below.
## Options
* `--disable-http` - Disables the creation of a publicly accessible
HTTP endpoint to your Vagrant environment. With this set, the only way
to access your share is with `vagrant connect`.
* `--http PORT` - The port of the HTTP server running in the Vagrant
environment. By default, Vagrant will attempt to find this for you.
This has no effect if `--disable-http` is set.
* `--https PORT` - The port of an HTTPS server running in the Vagrant
environment. By default, Vagrant will attempt to find this for you.
This has no effect if `--disable-http` is set.
* `--ssh` - Enables SSH sharing (more information below). By default, this
is not enabled.
* `--ssh-no-password` - Disables the encryption of the SSH keypair created
when SSH sharing is enabled.
* `--ssh-port PORT` - The port of the SSH server running in the Vagrant
environment. By default, Vagrant will attempt to find this for you.
* `--ssh-once` - Allows SSH access only once. After the first attempt to
connect via SSH to the Vagrant environment, the generated keypair is
destroyed.