Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!
Project Description
# Treadmill

[![Build Status](](
## Download
wget -O /usr/bin/treadmill && chmod +x /usr/bin/treadmill
This will put `treadmill` in your path.

## Vagrant setup for development

### Prerequisites
* [VirtualBox](
* [Vagrant](
* Install the [Guest Additions plugin]( for Vagrant
``` sh
vagrant plugin install vagrant-vbguest
### Vagrant Setup
* Clone the [treadmill]( repo.
* Clone the [treadmill-pid1]( repo.
* Run the following commands
``` sh
cd treadmill
git checkout standard_setup
vagrant up
vagrant ssh
* Create the cgroup folders as root
``` sh
sudo su -
cd /sys/fs/cgroup
for i in *; do mkdir -p $i/treadmill/apps $i/treadmill/core $i/system ; done
cd -
* Start the zookeeper service
``` sh
cd /home/centos && zookeeper-3.4.9/bin/ start
* Make the mount private
``` sh
sudo mount --make-rprivate /
* Treadmill should now be available on the box
``` sh
source /home/centos/env/bin/activate
treadmill --help

### Treadmill cli cheatsheet
``` sh
treadmill sproc scheduler /tmp
treadmill sproc service --root-dir /tmp/treadmill/ localdisk --reserve 20G --img-location /tmp/treadmill --default-read-bps 100M --default-write-bps 100M --default-read-iops 300 --default-write-iops 300
treadmill sproc service --root-dir /tmp/treadmill/ network
treadmill sproc service --root-dir /tmp/treadmill/ cgroup

# Zookeeper shell
create /scheduled/ {"memory":"100M","cpu":"10%","disk":"500M","proid":"centos","affinity":"","services":[{"name":"sleep","command":"/bin/top","restart":{"limit":5,"interval":60}}]}
create /servers/localhost.localdomain {"parent":"all:unknown","features":[],"traits":[],"label":null,"valid_until":1488573090.0}
create /cell/all:unknown {}
create /buckets/all:unknown {"parent":null,"traits":0}

# System shell
treadmill sproc init --approot /tmp/treadmill/
cd /tmp/treadmill/running && nohup /bin/s6-svscan > s6_svscan.out & && cd -
treadmill sproc eventdaemon
treadmill sproc appcfgmgr
Release History

Release History

This version
History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
Treadmill-0.0.2-py3.4.egg (923.3 kB) Copy SHA256 Checksum SHA256 3.4 Egg Apr 11, 2017
Treadmill-0.0.2.tar.gz (279.0 kB) Copy SHA256 Checksum SHA256 Source Apr 11, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting