Skip to content

Install and test Glances DEVELOP version

Nicolas Hennion edited this page May 28, 2025 · 34 revisions

If you want to install and test the DEVELOP branch without deleting/uninstall your stable version, you can follow one of those procedures.

Procedure number 1: Use the Pypi Test repository in a virtual environment

Create a Python virtual environment

python3 -m venv venv-test-glances

Go inside:

cd venv-test-glances
cd bin

Install some deps

./pip install setuptools

If you are not on Windows operating system:

./pip install shtab

Then install the targeted Glances version (example for Glances 4.3.2.dev4):

./pip install -i https://test.pypi.org/simple/ Glances==4.3.2.dev4

Check the result:

./glances -V
Glances version:	4.3.2_dev04
Glances API version:	4
PsUtil version:		5.8.0
Log file:		/home/nicolargo/.local/share/glances/glances.log

Procedure number 2: Install the full development stack

Install pre-resquisites:

pip install --user virtualenv

On Debian like system:

apt install python-dev 

On Redhat like system:

dnf install python-develop 

Note: on others Linux Operating System please install the statics Python development libraries.

Download Glances

mkdir ~/tmp
cd ~/tmp
git clone -b develop https://github.com/nicolargo/glances.git
cd ~/tmp/glances
git checkout develop

Create the test environment

cd ~/tmp/glances
make venv

Test the environment

cd ~/tmp/glances
make test

Run the Glances DEVELOP version

Standalone mode

cd ~/tmp/glances
make run

Client/Server mode

Run the server (on a first terminal):

cd ~/tmp/glances
make run-server

And the client (on a second terminal):

cd ~/tmp/glances
make run-client

Browser mode (on a third terminal)

cd ~/tmp/glances
make run-browser

Webserver mode

Run the server:

cd ~/tmp/glances
make run-webserver

And the client in your favorite Web browser: http://@IPSERVER:61208

Where @IPSERVER is the IP address or hostname where the Glances server is running (localhost if server and client are ran on the same machine).

How to report a bug ?

First of all, try to run Glances with the -d (Debug) flag on the command line. A glances.log file will be generated with a lot of information (to find the glances.log path, please run 'make show-version').

Then you need a GitHub account (it's free...) to log bug on the Glances' tracker.

Click on this link and enter the following information:

  • Glances and PsUtil version (output of make show-version command)
  • System configuration: Operating system name and version (output of uname -a and python -V on GNU/Linux)
  • Problem description (in English) and optionaly error message displayed by Glances
  • A copy/paste of relevant messages in the log file (glances.log)
  • A copy/paste of make show-issue

Thanks for your time !

Clone this wiki locally