Installing Replicated with the Easy Install Script

Instructions for installing Replicated via the easy install script.

We provide an easy-to-use one-line installation process (via shell script) which will detect your OS, ask a few questions and install both docker-engine and the required Replicated components.

If you want to always release your application with a specific version of Replicated you can read how to always install a specific version of Replicated.

Basic Install

Save the install script to file and run. We recommend reading and understanding the install script prior to running.

curl -sSL -o install.sh https://get.replicated.com/docker
sudo bash ./install.sh

Quick install

curl -sSL https://get.replicated.com/docker | sudo bash

Release Channel Install Scripts

Every release channel for your application has a custom install link. Using the channel install link allows the Replicated installer will optimize the install process. Based on your app YAML the installer will choose the highest allowed version of Replicated using your configured replicated_version range.

To find the install link, login to your vendor.replicated.com account, select your app and click “build history” for your channel and click “Copy install script url”.

Flags

The install script takes optional flags to configure Replicated for your environment.

Flag Usage
http-proxy Sets the HTTP proxy for Docker and Replicated
no-proxy Skip the proxy prompt
private-address Set the nodes private IP address
public-address Set the nodes public IP (service) address
no-auto Prompts will wait indefinitely instead of 20 second timeouts
ui-bind-port Change the default UI port binding from port 8800
docker-version Install with a specific version of Docker
no-docker Skip the docker installation
bypass-storagedriver-warnings For automation bypasses the warning for devicemapper with loopback

Example call with flags:

curl -sSL https://get.replicated.com/docker | sudo bash -s no-auto ui-bind-port=8000

Best practices with the easy-install script

When you’re ready to start shipping to customers we recommend that you proxy this install script with a TLS cert matching your domain name. The script should always be served with TLS.

Installing Behind A Proxy

The Replicated installation script supports environments where an HTTP proxy server is required to access the Internet. The installation script will prompt for the proxy address and will set up Replicated and Docker to use the supplied value.

An example of running the Replicated installation script with a proxy server is:

curl -x http://<proxy_address>:<proxy_port> https://get.replicated.com/docker | sudo bash

Post-Installation Maintenance

Upgrade to latest Replicated build

If you would like to upgrade Replicated to the latest release simply rerun the installation script and that will upgrade the Replicated components to the latest build.

Restarting Replicated

If you installed Replicated using the easy installation script, the script will have created an init service you can use to control Replicated. In this case, restarting replicated varies depending on your host OS.

Ubuntu/Debian

service replicated restart
service replicated-ui restart
service replicated-operator restart

CentOS/RHEL/Fedora

sudo systemctl restart replicated replicated-ui replicated-operator

Removing Replicated

To remove Replicated run the following script.

Ubuntu/Debian

service replicated stop
service replicated-ui stop
service replicated-operator stop
docker stop replicated-premkit
docker stop replicated-statsd
docker rm -f replicated replicated-ui replicated-operator replicated-premkit replicated-statsd
docker images | grep "quay\.io/replicated" | awk '{print $3}' | xargs sudo docker rmi -f
apt-get remove -y replicated replicated-ui replicated-operator
apt-get purge -y replicated replicated-ui replicated-operator
rm -rf /var/lib/replicated* /etc/replicated* /etc/init/replicated* /etc/init.d/replicated* /etc/default/replicated* /var/log/upstart/replicated* /etc/systemd/system/replicated*

CentOS/RHEL/Fedora

systemctl stop replicated replicated-ui replicated-operator
service replicated stop
service replicated-ui stop
service replicated-operator stop
docker stop replicated-premkit
docker stop replicated-statsd
docker rm -f replicated replicated-ui replicated-operator replicated-premkit replicated-statsd
docker images | grep "quay\.io/replicated" | awk '{print $3}' | xargs sudo docker rmi -f
yum remove -y replicated replicated-ui replicated-operator
rm -rf /var/lib/replicated* /etc/replicated* /etc/init/replicated* /etc/default/replicated* /etc/systemd/system/replicated* /etc/sysconfig/replicated* /etc/systemd/system/multi-user.target.wants/replicated* /run/replicated*