Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Deprecation Notice

This tool is deprecated in favor of the DC/OS E2E CLI.

That means that we do not guarantee that DC/OS Vagrant will continue to work.

We aim to provide all the same functionality, and more, in the DC/OS E2E CLI.

Let us know if anything you have been using this tool for is not covered by the DC/OS E2E CLI.

Deprecated - DC/OS Vagrant

Quickly provision a DC/OS cluster on a local machine for development, testing, or demonstration.

Deploying DC/OS Vagrant involves creating a local cluster of VirtualBox VMs using the dcos-vagrant-box base image and then installing DC/OS.

Build Status

Issue Tracking

  • Issue tracking is in DCOS JIRA.
  • Remember to make a DC/OS JIRA account and login so you can get update notifications!

Quick Start

  1. Install Git, Vagrant, and VirtualBox

  2. Install vagrant-hostmanager plugin

    vagrant plugin install vagrant-hostmanager
  3. Clone, Configure, and Deploy

    git clone
    cd dcos-vagrant
    cp VagrantConfig-1m-1a-1p.yaml VagrantConfig.yaml
    vagrant up

    When prompted for a password, provide your local machine user password (modifies /etc/hosts).

  4. Access the GUI http://m1.dcos/

  5. Install the DC/OS CLI


For more detailed instructions, see Deploy and Configure.

DC/OS Versions

Official releases of DC/OS can be found at

By default, DC/OS Vagrant uses the latest stable version of DC/OS.

To use a different stable or early access version, specify the version explicitly (must be in the list of known releases):

export DCOS_VERSION=1.9.0-rc1
vagrant up

To use a bleeding edge master, enterprise, or custom build, download the installer yourself, place it under the dcos-vagrant directory, and configure DC/OS Vagrant to use it:

export DCOS_CONFIG_PATH=etc/config-1.9.yaml
vagrant up

DC/OS Vagrant Documentation

How Do I...?


Copyright 2015-2017 Mesosphere, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this repository except in compliance with the License.

The contents of this repository are solely licensed under the terms described in the LICENSE file included in this repository.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.