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
Because DC/OS 1.8 is not the latest release, you will need to build your own local Universe image. Follow these instructions, skipping step 3.
Load the container into the local Docker instance on each of your master nodes:
docker load < local-universe.tar.gz
Download the dcos-local-universe-http.service definition.
dcos-local-universe-http.servicedefinition to each of your masters at
/etc/systemd/system/dcos-local-universe-http.serviceand 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
Download the dcos-local-universe-registry.service definition.
dcos-local-universe-registry.servicedefinition to each of your masters at
/etc/systemd/system/dcos-local-universe-registry.serviceand 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
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.
Add the local repository by using the DC/OS CLI.
dcos package repo add local-universe http://master.mesos:8082/repo
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:
SSH to your agents node.
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:8082from 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
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/hostsand get the images working.
I don’t see the package I was looking for
By default, only the
selectedpackages are bundled. If you’d like to get something else, use the build your own instructions.
- Unix/Linux: See these installation instructions.
To install your own set of packages you must build a customized local Universe Docker image.
Clone the Universe repository:
git clone https://github.com/mesosphere/universe.git --branch version-3.x
cd universe/docker/local-universe/ sudo make base
mesosphere/universeDocker image and compress it to the
local-universe.tar.gzfile. Specify a comma-separated list of package names and versions using the
DCOS_PACKAGE_INCLUDEvariable. To minimize the container size and download time, you can select only what you need. If you do not use the
DCOS_PACKAGE_INCLUDEvariable, all selected Universe packages will be included. To view which packages are selected, click on the Catalog tab in the DC/OS web interface.
sudo make DCOS_VERSION=1.8 DCOS_PACKAGE_INCLUDE="cassandra:1.0.25-3.0.10,marathon:1.4.2" local-universe
Perform all of the steps in the Installing the default Universe packages section. But instead of using the default local-package container, use the package file you just built.