Installing and Upgrading DC/OS Open Source

OPEN SOURCE

DC/OS can be installed on any cluster of physical or virtual machines.

Local Installation

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.

Cloud Provisioning

For users deploying to the public cloud, DC/OS offers configurable cloud provisioning templates for AWS, Azure, and GCE that will manage virtual machines and DC/OS installation.

DC/OS can be installed on other public and private clouds using the Datacenter Installation process, provided virtual machines and networks are created first.

Custom Installation

For new users installing to existing virtual or physical machines, on-premises or in the cloud, the GUI Installer provides a guided experience for bootstrapping a DC/OS cluster.

For advanced users installing to existing virtual or physical machines, on-premises or in the cloud, the Advanced Installer provides a scriptable, automatable interface to integrate with your preferred configuration management system.

DC/OS Custom Installation Options

You can install DC/OS on bare metal, virtual machines and every cloud. With the custom installers, you have the flexibility to configure each installation of DC/OS exactly how you like it.…Read More

DC/OS Cloud Installation Options

Looking to install DC/OS on your cloud of choice? Look no further! You can use a template or use our advanced custom installer.…Read More

Install DC/OS with Vagrant

DC/OS Vagrant uses Vagrant and VirtualBox to create a cluster of virtual machines on your local machine that can be used for demos, development, and testing with DC/OS.…Read More

Upgrading

This document provides instructions for upgrading a DC/OS cluster from version 1.9 to 1.10. If this upgrade is performed on a supported OS with all prerequisites fulfilled, this upgrade should preserve the state of running tasks on the cluster. This document reuses portions of the Advanced DC/OS Installation Guide.…Read More

Opt-Out

You can opt-out of the provided authentication by disabling it for your cluster. To disable authentication, add this parameter to your config.yaml file during installation (note this requires using the CLI or advanced installers):…Read More

DC/OS Ports

DC/OS components listen on multiple ports on each node. These ports must be available for installation to succeed.…Read More

High Availability

This document discusses the high availability (HA) features in DC/OS and best practices for building HA applications on DC/OS.…Read More

Frequently Asked Questions

We recommend starting with a fresh cluster to ensure all defaults are set to expected values. This prevents unexpected conditions related to mismatched versions and configurations.…Read More

Troubleshooting

Verify you have a valid IP detect⁠⁠⁠⁠ script, functioning DNS resolvers to bind the DC/OS services to, and that all nodes are synchronized with NTP.…Read More