Deploying a local Universe

Preview Updated: February 23, 2017

You can install and run DC/OS services on a datacenter without internet access with a local Universe. You can install a local Universe that includes the default packages (easiest), or select your own set of local Universe packages (advanced).

Important: macOS is not supported.


  • 8.5 GB of disk space
  • System must meet bootstrap node hardware prerequisites
  • Network access to port 8082 on all master nodes

Installing the default Universe packages

  1. SSH to the master nodes and download the local-universe container to each of your masters.

    Tip: The local-universe.tar.gz file size is 2 GB or more.

  2. Load the container into the local Docker instance on each of your master nodes:

    $ docker load < local-universe.tar.gz
  3. Download the dcos-local-universe-http.service definition.

  4. Add the dcos-local-universe-http.service definition to each of your masters at /etc/systemd/system/dcos-local-universe-http.service and then start it.

    $ cp dcos-local-universe-http.service /etc/systemd/system/dcos-local-universe-http.service
    $ systemctl daemon-reload
    $ systemctl enable dcos-local-universe-http
    $ systemctl start dcos-local-universe-http
  5. Download the dcos-local-universe-registry.service definition.

  6. Add the dcos-local-universe-registry.service definition to each of your masters at /etc/systemd/system/dcos-local-universe-registry.service and then start it.

    $ cp dcos-local-universe-registry.service /etc/systemd/system/dcos-local-universe-registry.service
    $ systemctl daemon-reload
    $ systemctl enable dcos-local-universe-registry
    $ systemctl start dcos-local-universe-registry
  7. Remove the DC/OS Universe repository from a host that has the DC/OS CLI installed. The Universe repository is installed by default with the CLI.
    $ dcos package repo remove Universe

    Tip: You can also add or remove repositories by using the DC/OS web interface. Simply go to System > Overview > Repositories.

  8. Add the local repository by using the DC/OS CLI.

    $ dcos package repo add local-universe http://master.mesos:8082/repo
  9. To pull from this new repository, you must setup the Docker daemon on every agent to have a valid SSL certificate. For each agent node:
    1. SSH to your agents node.

    2. Run the following commands:

      $ mkdir -p /etc/docker/certs.d/master.mesos:5000
      $ curl -o /etc/docker/certs.d/master.mesos:5000/ca.crt http://master.mesos:8082/certs/domain.crt
      $ systemctl restart docker

    Tip: You can use the instructions for insecure registries, instead of this step, however we don’t recommend this.


  • I can’t install CLI subcommands

    Packages are hosted at master.mesos:8082. If you cannot resolve or connect to master.mesos:8082 from your DC/OS CLI install, you cannot install CLI subcommands. If you can connect to port 8082 on your masters, add the IP for one of the masters to /etc/hosts.

  • The images are broken

    All Universe components are hosted inside of your cluster, including the images. The components are served up by master.mesos:8082. If you have connectivity to that IP, you can add it to /etc/hosts and get the images working.

  • I don’t see the package I was looking for

    By default, only the selected packages are bundled. If you’d like to get something else, use the build your own instructions.

Installing a selected set of Universe packages


To install your own set of packages you must build a customized local Universe Docker image.

  1. Clone the Universe repository:
    $ git clone https://github.com/mesosphere/universe.git --branch version-3.x
  2. Build the universe-base image:
    $ cd universe/docker/local-universe/
    $ sudo make base
  3. Inside the Makefile replace --selected flag with the comma-separated list of selected packages preceeded by --include flag. To minimize the container size and download time, you can select only what you need. If you do not modify the Makefile, all selected Universe packages will be included. To view which packages are selected, click on the Universe tab in the DC/OS web interface.
    $ sed -i -e 's/--selected/--include="marathon-lb,zeppelin"/' Makefile
  4. Build mesosphere/universe image and compress it to the local-universe.tar.gz file:
    $ sudo make local-universe
  5. Perform steps from 2 to 7 of Installing the default Universe packages section, except step 6. Run the following command instead:
    $ dcos package repo add local-universe http://master.mesos:8082/repo