Skip to content

SagaieNet/glances

 
 

Repository files navigation

Follow Glances on Twitter: @nicolargo or @glances_system

Give Glances some Bitcoin: 18Nbs6kg9UCqtX4RPDM3qMkeKwjDxBFYrW

Glances - An eye on your system

image

image

image

Downloads

image

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

It uses the psutil library to get information from your system.

image

Requirements

  • python >= 2.6 (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]
  • pysnmp (for SNMP support)

Installation

Glances Auto Install script

Just enter the following command line:

curl -L http://bit.ly/glances | /bin/bash

Note: Only supported on some GNU/Linux distributions. If you want to support others distribs, 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.

To upgrade Glances to the latest version:

pip install --upgrade Glances

GNU/Linux

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

  • Arch Linux
  • Debian (Testing/Sid)
  • Fedora/CentOS/RHEL
  • Gentoo
  • Slackware
  • Ubuntu (13.04+)
  • Void Linux

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

FreeBSD

To install the binary package:

# pkg_add -r py27-glances

Using pkgng:

# pkg install py27-glances

To install Glances from ports:

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

OS X

OS X users can install Glances using Homebrew or MacPorts.

Homebrew

$ brew install python
$ pip install Glances

MacPorts

$ sudo port install glances

Windows

Source

To install Glances version X.Y from source:

$ curl -L https://github.com/nicolargo/glances/archive/vX.Y.tar.gz -o glances-X.Y.tar.gz
$ tar -zxvf glances-*.tar.gz
$ cd glances-*
# python setup.py install

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

Puppet

You can install Glances using Puppet: https://github.com/rverchere/puppet-glances

Usage

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.

And RTFM, always.

Documentation

For complete documentation see glances-doc.

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

Author

Nicolas Hennion (@nicolargo) <nicolas@nicolargo.com>

License

LGPL. See COPYING for more details.