{"id":18479529,"url":"https://github.com/parallels/docker-machine-parallels","last_synced_at":"2025-04-12T15:43:58.273Z","repository":{"id":46700575,"uuid":"43330318","full_name":"Parallels/docker-machine-parallels","owner":"Parallels","description":"Parallels driver for Docker Machine https://github.com/docker/machine","archived":false,"fork":false,"pushed_at":"2023-12-18T13:02:44.000Z","size":2055,"stargazers_count":471,"open_issues_count":14,"forks_count":35,"subscribers_count":21,"default_branch":"master","last_synced_at":"2024-10-29T16:22:36.465Z","etag":null,"topics":["docker","docker-machine","hacktoberfest","parallels"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Parallels.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2015-09-28T22:19:16.000Z","updated_at":"2024-10-21T06:19:58.000Z","dependencies_parsed_at":"2023-12-18T14:31:39.152Z","dependency_job_id":"9f7a1cd1-705d-49e6-940a-79399343a1b6","html_url":"https://github.com/Parallels/docker-machine-parallels","commit_stats":{"total_commits":123,"total_committers":10,"mean_commits":12.3,"dds":0.08130081300813008,"last_synced_commit":"a1c3d495487413bdd24a562c0edee1af1cfc2f0f"},"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Parallels%2Fdocker-machine-parallels","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Parallels%2Fdocker-machine-parallels/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Parallels%2Fdocker-machine-parallels/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Parallels%2Fdocker-machine-parallels/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Parallels","download_url":"https://codeload.github.com/Parallels/docker-machine-parallels/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248590987,"owners_count":21129927,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","docker-machine","hacktoberfest","parallels"],"created_at":"2024-11-06T12:15:16.208Z","updated_at":"2025-04-12T15:43:58.254Z","avatar_url":"https://github.com/Parallels.png","language":"Go","readme":"# Docker Machine Parallels Driver\n\nThis is a plugin for [Docker Machine](https://docs.docker.com/machine/) allowing\nto create Docker hosts locally on [Parallels Desktop for Mac](http://www.parallels.com/products/desktop/)\n\n## Requirements\n\n* macOS 10.11+\n* [Docker Machine](https://docs.docker.com/machine/) 0.5.1+ (is bundled to\n  [Docker Toolbox](https://www.docker.com/docker-toolbox) 1.9.1+)\n* [Parallels Desktop](http://www.parallels.com/products/desktop/) 11.0.0+ **Pro** or\n**Business** edition (_Standard edition is not supported!_)\n\n**Attention!** This will not work on the new Apple Silicon Macs.\n\n## Installation\n\nInstall via [MacPorts](https://www.macports.org):\n\n```console\nsudo port install docker-machine-parallels\n```\n\nInstall via [Homebrew](https://brew.sh):\n\n```console\nbrew install docker-machine-parallels\n```\n\nTo install this plugin manually, download the binary `docker-machine-driver-parallels`\nand  make it available by `$PATH`, for example by putting it to `/usr/local/bin/`:\n\n```console\ncurl -L https://github.com/Parallels/docker-machine-parallels/releases/download/v2.0.1/docker-machine-driver-parallels \u003e /usr/local/bin/docker-machine-driver-parallels\n\nchmod +x /usr/local/bin/docker-machine-driver-parallels\n```\n\nThe latest version of `docker-machine-driver-parallels` binary is available on\nthe [\"Releases\"](https://github.com/Parallels/docker-machine-parallels/releases) page.\n\n## Usage\n\nOfficial documentation for Docker Machine [is available here](https://docs.docker.com/machine/).\n\nTo create a Parallels Desktop virtual machine for Docker purposes just run this\ncommand:\n\n```\ndocker-machine create --driver=parallels prl-dev\n```\n\nAvailable options:\n\n* `--parallels-boot2docker-url`: The URL of the boot2docker image.\n* `--parallels-disk-size`: Size of disk for the host VM (in MB).\n* `--parallels-memory`: Size of memory for the host VM (in MB).\n* `--parallels-cpu-count`: Number of CPUs to use to create the VM (-1 to use the number of CPUs available).\n* `--parallels-video-size`: Size of video memory for host (in MB).\n* `--parallels-share-folder`: Path to the directory which should be shared with the host VM. Could be specified multiple times, once per each directory.\n* `--parallels-no-share`: Disable the sharing of any directory.\n* `--parallels-nested-virtualization`: Enable nested virtualization.\n\nThe `--parallels-boot2docker-url` flag takes a few different forms. By\ndefault, if no value is specified for this flag, Machine will check locally for\na boot2docker ISO. If one is found, that will be used as the ISO for the\ncreated machine. If one is not found, the latest ISO release available on\n[boot2docker/boot2docker](https://github.com/boot2docker/boot2docker) will be\ndownloaded and stored locally for future use.\n\nThis is the default behavior (when `--parallels-boot2docker-url=\"\"`), but the\noption also supports specifying ISOs by the `http://` and `file://` protocols.\n\nEnvironment variables and default values:\n\n| CLI option                          | Environment variable        | Default                  |\n|-------------------------------------|-----------------------------|--------------------------|\n| `--parallels-boot2docker-url`       | `PARALLELS_BOOT2DOCKER_URL` | _Latest boot2docker url_ |\n| `--parallels-cpu-count`             | `PARALLELS_CPU_COUNT`       | `1`                      |\n| `--parallels-disk-size`             | `PARALLELS_DISK_SIZE`       | `20000`                  |\n| `--parallels-memory`                | `PARALLELS_MEMORY_SIZE`     | `1024`                   |\n| `--parallels-video-size`            | `PARALLELS_VIDEO_SIZE`      | `64`                     |\n| `--parallels-share-folder`          | -                           | `/Users`                 |\n| `--parallels-no-share`              | -                           | `false`                  |\n| `--parallels-nested-virtualization` | -                           | `false`                  |\n\n## Development\n\n### Build from Source\n\nIf you wish to work on Parallels Driver for Docker machine, you'll first need\n[Go](http://www.golang.org) installed (version 1.14+ is required).\nMake sure Go is properly installed, including setting up a [GOPATH](http://golang.org/doc/code.html#GOPATH).\n\nRun these commands to build the plugin binary:\n\n```bash\ngo get -d github.com/Parallels/docker-machine-parallels\ncd $GOPATH/src/github.com/Parallels/docker-machine-parallels\nmake build\n```\n\nAfter the build is complete, `bin/docker-machine-driver-parallels` binary will\nbe created. If you want to copy it to the `${GOPATH}/bin/`, run `make install`.\n\n### Managing Dependencies\n\nWhen you make a fresh copy of the repo, all the dependencies are in `vendor/` directory for the build to work.\nThis project uses [golang/dep](https://golang.github.io/dep/) as dependency management tool.\nPlease refer to [`dep` documentation](https://golang.github.io/dep/docs/introduction.html) for further details.\n\n### Acceptance Tests\n\nWe use [Bats](https://github.com/sstephenson/bats) for acceptance testing, so,\n[install it](https://github.com/sstephenson/bats#installing-bats-from-source) first.\n\nYou also need to build the plugin binary by calling `make build`.\n\nThen you can run acceptance tests using this command:\n\n```bash\nmake test-acceptance\n```\n\nAcceptance tests will invoke the general `docker-machine` binary available by\n`$PATH`. If you want to specify it explicitly, just set `MACHINE_BINARY` env variable:\n\n```bash\nMACHINE_BINARY=/path/to/docker-machine make test-acceptance\n```\n\n## Authors\n\n* Mikhail Zholobov ([@legal90](https://github.com/legal90))\n* Rickard von Essen ([@rickard-von-essen](https://github.com/rickard-von-essen))\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparallels%2Fdocker-machine-parallels","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fparallels%2Fdocker-machine-parallels","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparallels%2Fdocker-machine-parallels/lists"}