grafana-server - Man Page

back-end server for the Grafana metrics dashboard and graph editor

Description

grafana-server is the back-end server for the Grafana metrics dashboard and graph editor. The grafana-server program should not normally be run from the command line, except when testing or for development purposes. Rather it should be managed by systemd. After installing Grafana, the systemd service should be enabled and started as follows:

systemctl daemon-reload
systemctl enable grafana-server.service
systemctl start grafana-server.service

Commands

target

Target specific grafana services

help, h

Shows a list of commands or help for one command

Options

The grafana-server configuration is specified in /etc/grafana/grafana.ini and is well documented with comments. The command-line options listed below override options of the same (or similar) name in the configuration file.

--config value

Path to config file

--homepath value

Path to Grafana install/home path, defaults to working directory

--pidfile value

Path to Grafana pid file

--packaging value

describes the way Grafana was installed (default: "unknown")

--configOverrides value

Configuration options to override defaults as a string. e.g. cfg:default.paths.log=/dev/null

--version,  -v

print the version

--vv

prints current version, all dependencies and exits

--profile

Turn on pprof profiling

--profile-addr value

Define custom address for profiling (default: "localhost")

--profile-port value

Define custom port for profiling (default: 6060)

--profile-block-rate value

Controls the fraction of goroutine blocking events that are reported in the blocking profile. The profiler aims to sample an average of one blocking event per rate nanoseconds spent blocked. To turn off profiling entirely, use 0 (default: 1)

--profile-mutex-rate value

Controls the fraction of mutex contention events that are reported in the mutex profile. On average 1/rate events are reported. To turn off mutex profiling entirely, use 0 (default: 0)

--tracing

Turn on tracing

--tracing-file value

Define tracing output file (default: "trace.out")

--help,  -h

show help

See Also

The full documentation for Grafana is available on-line at http://docs.grafana.org/.

Referenced By

grafana(1), PCPCompat(1), pmDiscoverSetup(3), pmseries_import(1).

March 2026 Version 12.4.2