Installing and Upgrading

Enterprise DC/OS Updated: June 8, 2017

Enterprise DC/OS is designed to be configured, deployed, managed, scaled, and upgraded on any cluster of physical or virtual machines. You can install DC/OS in the environment of your choice by using a customized setup file or cloud templates.

Deploy using a Setup File

The Enterprise DC/OS setup file is generated by using specific parameters that are set in your configuration file. This installation file contains a Bash install script and a Docker container that is loaded with everything you need to deploy a customized DC/OS build. The DC/OS setup file can be deployed using these methods:

GUI Installer

The GUI installer provides a simple graphical interface that guides you through the installation of DC/OS. The GUI installer provides a basic installation that is suitable for demonstrations and POCs. A shared SSH key is required for this method.

CLI Installer

The CLI installer provides a guided installation of DC/OS from the command line. With this method you can choose from the complete set of DC/OS configuration options. A shared SSH key is required for this method.

Advanced Installer

The advanced installer provides a scriptable, automatable interface to integrate with your preferred configuration management system. With this installation method, you package the DC/OS distribution yourself and connect to every node manually to run the DC/OS installation commands. This installation method is recommended if you want to integrate with an existing system or if you don’t have SSH access to your cluster.

Deploy using Cloud Templates

DC/OS offers configurable cloud provisioning templates for AWS that manage a DC/OS installation on virtual machines. The DC/OS templates for AWS CloudFormation bring power and flexibility to creating and extending DC/OS clusters. For more information, see the documentation.

Local Installer

The local installer deploys DC/OS with Vagrant. This method is designed for first-time users or developers looking to build services or modify DC/OS. The Vagrant installer provides a quick, free way to deploy a virtual cluster on a single machine.


This installation method uses Vagrant to create a cluster of virtual machines on your local machine that can be used for demos, development, and testing with DC/OS. System requirem...


This document provides instructions for upgrading a DC/OS cluster. If this upgrade is performed on a supported OS with all prerequisites fulfilled, this upgrade should preserve the...

DC/OS Ports

DC/OS components listen on multiple ports on each node. These ports must be available for installation to succeed. DC/OS allocates additional ports to services running on top of DC...

Frequently Asked Questions

Q. Can I install DC/OS on an already running Mesos cluster? We recommend starting with a fresh cluster to ensure all defaults are set to expected values. This prevents unexpected c...


General troubleshooting approach Verify that you have a valid IP detect⁠⁠⁠⁠script, functioning DNS resolvers to bind the DC/OS services to, and that all nodes are synchr...