{"id":13581934,"url":"https://github.com/vultr/docker-machine-driver-vultr","last_synced_at":"2026-03-06T17:05:19.048Z","repository":{"id":44705775,"uuid":"238944796","full_name":"vultr/docker-machine-driver-vultr","owner":"vultr","description":"Vultr Driver Plugin for Docker Machine","archived":false,"fork":false,"pushed_at":"2025-10-23T17:37:03.000Z","size":124,"stargazers_count":29,"open_issues_count":6,"forks_count":12,"subscribers_count":4,"default_branch":"master","last_synced_at":"2026-03-05T05:06:23.522Z","etag":null,"topics":["docker-machine","docker-machine-driver","vultr","vultr-api"],"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/vultr.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":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-02-07T14:32:08.000Z","updated_at":"2025-10-23T17:36:34.000Z","dependencies_parsed_at":"2024-06-12T16:38:58.591Z","dependency_job_id":"c6986dac-f1f7-4507-9e16-3d073e5a6e9d","html_url":"https://github.com/vultr/docker-machine-driver-vultr","commit_stats":{"total_commits":44,"total_committers":5,"mean_commits":8.8,"dds":0.6136363636363636,"last_synced_commit":"f30538be2d6ff5a91ff4bf42ff2ef35f65c0748f"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/vultr/docker-machine-driver-vultr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vultr%2Fdocker-machine-driver-vultr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vultr%2Fdocker-machine-driver-vultr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vultr%2Fdocker-machine-driver-vultr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vultr%2Fdocker-machine-driver-vultr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vultr","download_url":"https://codeload.github.com/vultr/docker-machine-driver-vultr/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vultr%2Fdocker-machine-driver-vultr/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30186780,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T14:42:24.748Z","status":"ssl_error","status_checked_at":"2026-03-06T14:42:14.925Z","response_time":250,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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-machine","docker-machine-driver","vultr","vultr-api"],"created_at":"2024-08-01T15:02:20.048Z","updated_at":"2026-03-06T17:05:19.025Z","avatar_url":"https://github.com/vultr.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# docker-machine-driver-vultr\n\nVultr Driver for docker-machine and Rancher Node Driver\n\n## Install as a docker-machine driver\n\n`docker-machine` is now maintained by Rancher as `rancher-machine`. It is recommended to install `rancher-machine` instead. See the official repository: \u003chttps://github.com/rancher/machine\u003e.\n\n`docker-machine` is required, [see the installation documentation](https://gitlab.com/gitlab-org/ci-cd/docker-machine/-/blob/main/docs/install-machine.md).\n\nThen install the `docker-machine-driver-vultr` driver by copying the build to `/usr/local/bin/`.\n\n## Install as a Rancher Node Driver\n\nUse overlay2 as the storage engine\n\n### Installing Rancher-Machine\n\nTo install `rancher-machine` from source\n\n```bash\neval $(go env)\nexport PATH=\"$PATH:$GOPATH/bin\"\n```\n\n```bash\n# Download the Rancher Machine binary\ncurl -LO https://github.com/rancher/machine/releases/download/v0.15.0-rancher125/rancher-machine-amd64.tar.gz\n\n# Extract the downloaded archive\ntar -xzvf rancher-machine-amd64.tar.gz\n\n# Move the binary to a system path\nsudo mv rancher-machine /usr/local/bin/rancher-machine\n\n# Ensure the binary is executable\nsudo chmod +x /usr/local/bin/rancher-machine\n```\n\n\nAnd then compile the `docker-machine-driver-vultr` driver:\n\n```bash\ngo get -u github.com/vultr/docker-machine-driver-vultr@latest\ncd $GOPATH/src/github.com/vultr/docker-machine-driver-vultr\nmake install\n```\n\n## Run\n\nYou will need a Vultr APIv4 Personal API key. It is only available in the members area \u003chttps://my.vultr.com/settings/#settingsapi\u003e. You need to create an account (\u003chttps://www.vultr.com/register/\u003e) to get there.\n\nYou will also need to use the 19.03.9 install engine as shown in the example below:\n\n```bash\nrancher-machine create -d vultr --vultr-api-key=\u003cvultr-api-key\u003e --engine-install-url \"https://releases.rancher.com/install-docker/19.03.9.sh\" \u003cmachine-name\u003e\n```\n\n\n### Options\n\n| Argument                  | Env                       | Default | Description\n|---------------------------|---------------------------| --- | ---\n| `vultr-api-key`           | `VULTR_API_KEY`           | None | **required** Vultr API key (see [here](https://www.vultr.com/api/#overview))\n| `vultr-server-type`       | `VULTR_SERVER_TYPE`       | `1` | Vultr Server Type ( 1-SSD, 2-BareMetal, 3-DedicatedCloud)\n| `vultr-region`            | `VULTR_REGION`            | `1` (New Jersey) | VPS DCID (Region) (see [here](https://www.vultr.com/api/#regions))\n| `vultr-vps-plan-id`       | `VULTR_VPS_PLAN_ID`       | `201` (1024 MB RAM,25 GB SSD,1.00 TB BW) | VPS Plan ID (see [here](https://www.vultr.com/api/#plans))\n| `vultr-os-id`             | `VULTR_OS_ID`             | `1743` (Ubuntu 22.04 x64) | VPS Operating System ID (see [here](https://www.vultr.com/api/#os))\n| `vultr-ipxe-chain-url`    | `VULTR_IPXE_CHAIN_URL`    | None | (optional) If you've selected the 'custom' operating system, this can be set to chainload the specified URL on bootup, via iPXE\n| `vultr-iso-id`            | `VULTR_ISO_ID`            | None | (optional) If you've selected the 'custom' operating system, this is the ID of a specific ISO to mount during the deployment\n| `vultr-script-id`         | `VULTR_SCRIPT_ID`         | None | (optional) If you've not selected a 'custom' operating system, this can be the SCRIPTID of a startup script to execute on boot\n| `vultr-snapshot-id`       | `VULTR_SNAPSHOT_ID`       | None | (optional) If you've selected the 'snapshot' operating system, this should be the SNAPSHOTID (see v1/snapshot/list) to restore for the initial installation\n| `vultr-app-id`            | `VULTR_APP_ID`            | None | (optional) If launching an application (OSID 186), this is the APPID to launch\n| `vultr-reserved-ip-v4`    | `VULTR_RESERVED_IP_V4`    | None | (optional) IP address of the floating IP to use as the main IP of this server\n| `vultr-ip-v6`             | `VULTR_IP_V6`             | None | (optional) If true, an IPv6 subnet will be assigned to the machine (where available)\n| `vultr-auto-backups`      | `VULTR_AUTO_BACKUPS`      | None | (optional) If true, automatic backups will be enabled for this server (these have an extra charge associated with them)\n| `vultr-private-network`   | `VULTR_PRIVATE_NETWORK`   | None | (optional) If true, private networking support will be added to the new server\n| `vultr-network-id`        | `VULTR_NETWORK_ID`        | None | (optional) List of private networks to attach to this server. Use either this field or enable_private_network, not both\n| `vultr-notify-activate`   | `VULTR_NOTIFY_ACTIVATE`   | None | (optional) If true, an activation email will be sent when the server is ready\n| `vultr-ddos-protection`   | `VULTR_DDOS_PROTECTION`   | None | (optional) If true, DDOS protection will be enabled on the subscription (there is an additional charge for this)\n| `vultr-userdata`          | `VULTR_USERDATA`          | None | (optional) Base64 encoded user-data\n| `vultr-label`             | `VULTR_LABEL`             | None | (optional) This is a text label that will be shown in the control panel\n| `vultr-hostname`          | `VULTR_HOSTNAME`          | None | (optional) The hostname to assign to this server\n| `vultr-tag`               | `VULTR_TAG`               | None | (optional) The tag to assign to this server\n| `vultr-firewall-group-id` | `VULTR_FIREWALL_GROUP_ID` | None | (optional) The firewall group to assign to this server\n| `vultr-sshkey-id`         | `VULTR_SSHKEY_ID`         | None | (optional) List of SSH keys to apply to this server on install (only valid for Linux/FreeBSD)\n\n\n## Debugging\n\nDetailed run output will be emitted when using the `rancher-machine` `--debug` option.\n\n```bash\nrancher-machine --debug  create -d vultr --vultr-api-key=\u003cvultr-api-key\u003e machinename\n```\n\n## Examples\n\n### Simple Example\n\n```bash\nrancher-machine create -d vultr --vultr-api-key=\u003cvultr-api-key\u003e vultr\neval $(rancher-machine env vultr)\n```\n\n```bash\n$ rancher-machine ls\nNAME      ACTIVE   DRIVER   STATE     URL                         SWARM   DOCKER     ERRORS\nvultr     -        vultr    Running   tcp://207.246.87.114:2376           v19.03.5\n\n$ rancher-machine rm vultr\nAbout to remove vultr\nWARNING: This action will delete both local reference and remote instance.\nAre you sure? (y/n): y\nSuccessfully removed vultr\n```\n\n## Required Ports\n\nBy default, Vultr images have UFW enabled with only port 22 open. The default cloud-init script in this driver completely disables UFW, however, for production environments we recommend only opening specific ports as needed.\n\nThe port requirements for Rancher can be found here:\nhttps://ranchermanager.docs.rancher.com/getting-started/installation-and-upgrade/installation-requirements/port-requirements\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvultr%2Fdocker-machine-driver-vultr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvultr%2Fdocker-machine-driver-vultr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvultr%2Fdocker-machine-driver-vultr/lists"}