Menu

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Enterprise Open source

Restart Grafana

Users often need to restart Grafana after they have made configuration changes. This topic provides detailed instructions on how to restart Grafana supported operating systems.

Windows

To restart Grafana:

  1. Open the Services app.
  2. Right-click on the Grafana service.
  3. In the context menu, click Restart.

macOS

Restart methods differ depending on whether you installed Grafana using Homebrew or as standalone macOS binaries.

Restart Grafana using Homebrew

Use the Homebrew restart command:

bash
brew services restart grafana

Restart standalone macOS binaries

To restart Grafana:

  1. Open a terminal and go to the directory where you copied the install setup files.
  2. Run the command:
bash
./bin/grafana-server web

Linux

Restart methods differ depending on whether your Linux system uses systemd or init.d.

Restart the server with systemd

To restart the service and verify that the service has started, run the following commands:

bash
sudo systemctl restart grafana-server
sudo systemctl status grafana-server

Alternately, you can configure the Grafana server to restart at boot:

bash
sudo systemctl enable grafana-server.service

Note: SUSE or OpenSUSE users may need to start the server with the systemd method, then use the init.d method to configure Grafana to start at boot.

Restart the server with init.d

To restart the service, run the following command:

bash
sudo service grafana-server restart

or

bash
sudo /etc/init.d/grafana-server restart

Verify the status:

bash
sudo service grafana-server status

or

bash
sudo /etc/init.d/grafana-server status

Alternately, you can configure the Grafana server to restart at boot:

bash
sudo update-rc.d grafana-server defaults

Docker

To restart the Grafana service, use the docker restart command.

docker restart grafana

Alternately, you can use the docker compose restart command to restart Grafana. For more information, refer to docker compose documentation.

Docker compose example

Configure your docker-compose.yml file. For example:

bash
grafana:
  image: grafana/grafana:latest
  ports:
    - "3000:3000"
  environment:
    - TERM=linux
    - GF_INSTALL_PLUGINS=grafana-clock-panel,grafana-piechart-panel,grafana-polystat-panel

Start the Grafana server:

docker-compose up

This starts the Grafana server along with the three plugins specified in the YAML file.

To restart the running container, use this command:

docker-compose restart grafana