https://github.com/parallels/vagrant-parallels
Vagrant Parallels Provider
https://github.com/parallels/vagrant-parallels
parallels parallels-desktop plugin vagrant
Last synced: 2 months ago
JSON representation
Vagrant Parallels Provider
- Host: GitHub
- URL: https://github.com/parallels/vagrant-parallels
- Owner: Parallels
- License: mit
- Created: 2013-06-07T19:14:28.000Z (almost 13 years ago)
- Default Branch: master
- Last Pushed: 2025-04-28T07:53:58.000Z (12 months ago)
- Last Synced: 2025-04-28T14:07:20.199Z (12 months ago)
- Topics: parallels, parallels-desktop, plugin, vagrant
- Language: Ruby
- Homepage: https://parallels.github.io/vagrant-parallels
- Size: 69.4 MB
- Stars: 1,009
- Watchers: 43
- Forks: 89
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Vagrant Parallels Provider
[](https://badge.fury.io/rb/vagrant-parallels)
[](https://travis-ci.org/Parallels/vagrant-parallels)
[](https://codeclimate.com/github/Parallels/vagrant-parallels)
_Vagrant Parallels Provider_ is a plugin for [Vagrant](https://www.vagrantup.com),
allowing to manage [Parallels Desktop](https://www.parallels.com/products/desktop/)
virtual machines on macOS hosts.
## Requirements
- [Vagrant v1.9.7](https://www.vagrantup.com) or higher
- [Parallels Desktop 11 for Mac](https://www.parallels.com/products/desktop/) or higher
_Note:_ Only **Pro**, **Business** and **Enterprise** editions of **Parallels Desktop for Mac**
are compatible with this Vagrant provider.
Standard edition doesn't have a full command line functionality and can not be used
with Vagrant.
## Features
The Parallels provider supports all basic Vagrant features, including Shared Folders,
Private and Public Networking, Forwarded ports and Vagrant Share.
If you're just getting started with Vagrant, it is highly recommended that you
read the official [Vagrant documentation](https://docs.vagrantup.com/v2/) first.
## Installation
Make sure that you have [Parallels Desktop for Mac](https://www.parallels.com/products/desktop/)
and [Vagrant](https://www.vagrantup.com/downloads.html) properly installed. We recommend
that you use the latest versions of these products.
Additionally, you'll need the command line software development tools provided as a part of Xcode
to be able to build the plugin on your machine. To install these, run this command:
```shell
xcode-select --install
```
You can then install the Parallels provider plugin for Vagrant. Run this command to install it:
```shell
vagrant plugin install vagrant-parallels
```
## Provider Documentation
More information about the Parallels provider is available in
[Vagrant Parallels Documentation](https://parallels.github.io/vagrant-parallels/docs/)
We recommend you to start from these pages:
- [Usage](https://parallels.github.io/vagrant-parallels/docs/usage.html)
- [Getting Started](https://parallels.github.io/vagrant-parallels/docs/getting-started.html)
- [Boxes](https://parallels.github.io/vagrant-parallels/docs/boxes/index.html)
## Getting Help
If you have an issue with the Parallels provider or discover a bug,
please report it on the [Issue Tracker](https://github.com/Parallels/vagrant-parallels/issues).
## License and Authors
- Author: Youssef Shahin
- Author: Mikhail Zholobov
- Copyright 2013-2023, Parallels International GmbH.
Vagrant Parallels Provider is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).