Skip to main content

Load Balancer for TCP.

Project description


greenbalance is a simple TCP load balancer with round-robin and weighted random support built on gevent and wr.


Simple example; this will make the load balancer listen on port 8080 and use a custom configuration.

$ greenbalance --port 8080 --config /path/to/my.config


Arguments accepted by the greenbalance command.

--version Show program’s version number and exit.
-h, --help Show this help message and exit.
-H, --host IP or Hostname.
-p, --port Listening Port.
-c, --config Configuration file.
-l, --logfile Log File
-L, --loglevel Log Level (debug, info, warning, error, critical)


greenbalance.conf is by default placed in /etc if the package was intalled with root privileges. If you have the package installed in a virtualenv you will have to create a configuration file manually and pass it with the --config or -c argument.

host =           # Bind to this ( = all)
port = 3001              # Listening port.

loglevel = debug
logfile = /var/log/greenbalance.log

backend1 3101 = 20       # will serve 20% of the requests. 3102 = 40  # will serve 40% of the requests.
localhost 3103 = 40      # will serve 40% of the requests.


See below for OS-specific preparations.

Install greenbalance with:

sudo pip install greenbalance


sudo apt-get install python-pip python-gevent; sudo pip install --upgrade pip


Install python-pip and python-gevent from epel.


Documentation is available at



Project details

Download files

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

Files for greenbalance, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size greenbalance-0.2.0.tar.gz (4.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page