Command Reference

Command-Line Options

-h, --help

show this help message and exit

-V, --version

show program’s version number and exit

-d, --debug

enable debug mode

-C CONF_FILE, --config CONF_FILE

path to the configuration file

--modules-list

display modules (plugins & exports) list and exit

--disable-plugin PLUGIN

disable PLUGIN (comma separed list)

--enable-plugin PLUGIN

enable PLUGIN (comma separed list)

--stdout PLUGINS_STATS

display stats to stdout (comma separated list of plugins/plugins.attribute)

--export EXPORT

enable EXPORT module (comma separed list)

--export-csv-file EXPORT_CSV_FILE

file path for CSV exporter

--export-json-file EXPORT_JSON_FILE

file path for JSON exporter

--disable-process

disable process module (reduce Glances CPU consumption)

--disable-webui

disable the Web UI (only the RESTful API will respond)

--light, --enable-light

light mode for Curses UI (disable all but top menu)

-0, --disable-irix

task’s CPU usage will be divided by the total number of CPUs

-1, --percpu

start Glances in per CPU mode

-2, --disable-left-sidebar

disable network, disk I/O, FS and sensors modules

-3, --disable-quicklook

disable quick look module

-4, --full-quicklook

disable all but quick look and load

-5, --disable-top

disable top menu (QuickLook, CPU, MEM, SWAP and LOAD)

-6, --meangpu

start Glances in mean GPU mode

--enable-history

enable the history mode

--disable-bold

disable bold mode in the terminal

--disable-bg

disable background colors in the terminal

--enable-process-extended

enable extended stats on top process

-c CLIENT, --client CLIENT

connect to a Glances server by IPv4/IPv6 address, hostname or hostname:port

-s, --server

run Glances in server mode

--browser

start the client browser (list of servers)

--disable-autodiscover

disable autodiscover feature

-p PORT, --port PORT

define the client/server TCP port [default: 61209]

-B BIND_ADDRESS, --bind BIND_ADDRESS

bind server to the given IPv4/IPv6 address or hostname

--username

define a client/server username

--password

define a client/server password

--snmp-community SNMP_COMMUNITY

SNMP community

--snmp-port SNMP_PORT

SNMP port

--snmp-version SNMP_VERSION

SNMP version (1, 2c or 3)

--snmp-user SNMP_USER

SNMP username (only for SNMPv3)

--snmp-auth SNMP_AUTH

SNMP authentication key (only for SNMPv3)

--snmp-force

force SNMP mode

-t TIME, --time TIME

set refresh time in seconds [default: 3 sec]

-w, --webserver

run Glances in web server mode (bottle lib needed)

--cached-time CACHED_TIME

set the server cache time [default: 1 sec]

open-web-browser

try to open the Web UI in the default Web browser

-q, --quiet

do not display the curses interface

-f PROCESS_FILTER, --process-filter PROCESS_FILTER

set the process filter pattern (regular expression)

--process-short-name

force short name for processes name

--hide-kernel-threads

hide kernel threads in process list (not available on Windows)

-b, --byte

display network rate in byte per second

--diskio-show-ramfs

show RAM FS in the DiskIO plugin

--diskio-iops

show I/O per second in the DiskIO plugin

--fahrenheit

display temperature in Fahrenheit (default is Celsius)

--fs-free-space

display FS free space instead of used

--theme-white

optimize display colors for white background

--disable-check-update

disable online Glances version ckeck

Interactive Commands

The following commands (key pressed) are supported while in Glances:

ENTER

Set the process filter

Note

On macOS please use CTRL-H to delete filter.

Filter is a regular expression pattern:

  • gnome: matches all processes starting with the gnome string
  • .*gnome.*: matches all processes containing the gnome string
a

Sort process list automatically

  • If CPU >70%, sort processes by CPU usage
  • If MEM >70%, sort processes by MEM usage
  • If CPU iowait >60%, sort processes by I/O read and write
A
Enable/disable Application Monitoring Process
b
Switch between bit/s or Byte/s for network I/O
B
View disk I/O counters per second
c
Sort processes by CPU usage
d
Show/hide disk I/O stats
D
Enable/disable Docker stats
e
Enable/disable top extended stats
E
Erase current process filter
f
Show/hide file system and folder monitoring stats
F
Switch between file system used and free space
g
Generate graphs for current history
h
Show/hide the help screen
i
Sort processes by I/O rate
I
Show/hide IP module
k
Show/hide TCP connections
l
Show/hide log messages
m
Sort processes by MEM usage
M
Reset processes summary min/max
n
Show/hide network stats
N
Show/hide current time
p
Sort processes by name
q|ESC|CTRL-C
Quit the current Glances session
Q
Show/hide IRQ module
r
Reset history
R
Show/hide RAID plugin
s
Show/hide sensors stats
t
Sort process by CPU times (TIME+)
T
View network I/O as combination
u
Sort processes by USER
U
View cumulative network I/O
w
Delete finished warning log messages
W
Show/hide Wifi module
x
Delete finished warning and critical log messages
z
Show/hide processes stats
0

Enable/disable Irix/Solaris mode

Task’s CPU usage will be divided by the total number of CPUs

1
Switch between global CPU and per-CPU stats
2
Enable/disable left sidebar
3
Enable/disable the quick look module
4
Enable/disable all but quick look and load module
5
Enable/disable top menu (QuickLook, CPU, MEM, SWAP and LOAD)
6
Enable/disable mean GPU mode
/
Switch between process command line or command name

In the Glances client browser (accessible through the --browser command line argument):

ENTER
Run the selected server
UP
Up in the servers list
DOWN
Down in the servers list
q|ESC
Quit Glances