Join 10350+ others. No spamming.
I promise!

Follow us at github.



nicolargo / glances


Glances an Eye on your system. A top/htop alternative.


Glances - An eye on your system

Downloads this month Github stars

Follow Glances on Twitter: @nicolargo or @glances_system

Glances is a cross-platform curses-based system monitoring tool written in Python.


  • python >= 2.6 or >= 3.3 (tested with version 2.6, 2.7, 3.3, 3.4)
  • psutil >= 2.0.0
  • setuptools

Optional dependencies:

  • bottle (for Web server mode)
  • py3sensors (for hardware monitoring support) [Linux-only]
  • hddtemp (for HDD temperature monitoring support) [Linux-only]
  • batinfo (for battery monitoring support) [Linux-only]
  • pymdstat (for RAID support) [Linux-only]
  • pysnmp (for SNMP support)
  • zeroconf (for the autodiscover mode)
  • netifaces (for the IP plugin)
  • influxdb (for the InfluxDB export module)
  • statsd (for the StatsD export module)
  • pystache (for the action script feature)
  • docker-py (for the Docker monitoring support) [Linux-only]
  • matplotlib (for graphical/chart support)
  • pika (for the RabbitMQ/ActiveMQ export module)
  • py-cpuinfo (for the Quicklook CPU info module)


Glances Auto Install script

To install both dependencies and latest Glances production ready version (aka master branch), just enter the following command line:

curl -L | /bin/bash


wget -O- | /bin/bash

Note: Only supported on some GNU/Linux distributions. If you want to support other distributions, please contribute to glancesautoinstall.

PyPI: The simple way

Glances is on PyPI. By using PyPI, you are sure to have the latest stable version.

To install, simply use pip:

pip install glances

Note: Python headers are required to install psutil. For example, on Debian/Ubuntu you need to install first the python-dev package. For Fedora/CentOS/RHEL install first python-devel package.

You can also install the following libraries in order to use optional features (like the Web interface):

pip install bottle batinfo zeroconf netifaces pymdstat influxdb potsdb statsd pystache docker-py pysnmp pika py-cpuinfo

Install or upgrade Glances from the Git develop repository:

git clone -b develop

To upgrade Glances to the latest version:

pip install --upgrade glances

If you need to install Glances in a specific user location, use:

export PYTHONUSERBASE=~/mylocalpath
pip install --user glances


At the moment, packages exist for the following GNU/Linux distributions:

  • Arch Linux
  • Debian
  • Fedora/CentOS/RHEL
  • Gentoo
  • Slackware (SlackBuild)
  • Ubuntu
  • Void Linux

So you should be able to install it using your favorite package manager.


To install the binary package:

# pkg install py27-glances

To install Glances from ports:

# cd /usr/ports/sysutils/py-glances/
# make install clean


OS X users can install Glances using Homebrew or MacPorts.


$ brew install python
$ pip install glances


$ sudo port install glances


Install Python for Windows (Python 2.7.9+ and 3.4+ ship with pip) and then just:

$ pip install glances


To install Glances from source:

$ wget -O - | tar xz
$ cd glances-*
# python install

Note: Python headers are required to install psutil. For example, on Debian/Ubuntu you need to install first the python-dev package.


You can install Glances using Puppet:


For the standalone mode, just run:

$ glances

For the Web server mode, run:

$ glances -w

and enter the URL http://<ip>:61208 in your favorite web browser.

For the client/server mode, run:

$ glances -s

on the server side and run:

$ glances -c <ip>

on the client one.

You can also detect and display all Glances servers available on your network or defined in the configuration file:

$ glances --browser

and RTFM, always.


For complete documentation see glances-doc.

If you have any question (after RTFM!), please post it on the official Q&A forum.

Gateway to other services

Glances can export stats to: CSV file, InfluxDB, OpenTSDB, StatsD and RabbitMQ server.

How to contribute ?

If you want to contribute to the Glances project, read this wiki page.

There is also a chat dedicated to the Glances developers:


Nicolas Hennion (@nicolargo) <>


LGPL. See COPYING for more details.