Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
Aug 13, 2013


Serviced is a PaaS runtime. It allows users to create, manage and scale services in a uniform way.


Serviced can run on a single host or across multiple hosts. First, serviced depends on docker. The minimal version of docker should be 19.03.11 for running serviced 1.8.x. The minimum supported versions of Linux distributions are Ubuntu is 18.04 and CentOS 7.6.

  1. Follow the instruction at , to install it on every host that serviced will run on. Ensure docker is running.

  2. Install a generated package

        sudo apt-key adv --keyserver --recv-keys AA5A1AD7
        sudo sh -c 'echo "deb [ arch=amd64 ] trusty universe" > /etc/apt/sources.list.d/zenoss.list'
        sudo apt-get update
        sudo apt-get install -y serviced

    Or follow the steps below in the dev section to a source build.

  3. Elasticsearch 7.x uses a mmapfs directory by default to store its indices. The default operating system limits on mmap counts is likely to be too low, which may result in out of memory exceptions. On Linux, the limits should be increased by running the following command as root:

    sysctl -w vm.max_map_count=262144

    To set this value permanently, update the vm.max_map_count setting in /etc/sysctl.conf. To verify after rebooting, run sysctl vm.max_map_count.

  4. Start the service. On ubuntu,

    start serviced

    There will be some delay the first time serviced is started before it is ready for user requests. You can track the output of serviced at /var/log/upstart/serviced.log.

  5. Browse the UI at https://localhost


Serviced is a platform for running services. Serviced is composed of a master serviced process and agent processes running on each host. Each host must be registered with the master process. To register an agent process:

serviced host add HOST:PORT RESOURCE_POOL

Dev Environment

Serviced is written in Go. To install Go, download go v1.14.4 from Untar the distribution to /usr/local/go. If you use a different location for go, you must set GOROOT. See the for more information. Ensure that $GOROOT/bin is in you path. There's an easier way to install in Ubuntu

sudo snap install --classic --channel=1.14/stable go

Add your development user to the "docker" group.

sudo usermod -G docker -a $USER

Ubuntu 18.04 is the typical development environment. There are additional dependencies your install will need.

sudo apt-get install git mercurial libpam0g-dev make

With $GOROOT set and $GOROOT/bin in your $PATH, create a development workspace.

export GOPATH=~/mygo
export PATH="$PATH:$GOPATH/bin"
mkdir -p $GOPATH/{bin,pkg,src}
mkdir -p $GOPATH/src/
cd $GOPATH/src/
git clone
    # alternatively: git clone
cd serviced

After this, a binary should exist at $GOPATH/bin/serviced & $GOPATH/src/ You can run the server with

sudo serviced -master