Introduction
Grafana is an open-source analytics and monitoring platform that is widely used for visualizing metrics data. Installing Grafana is a straightforward process, but it can vary depending on the operating system you are using. In this guide, we will provide you with step-by-step instructions for installing Grafana on different operating systems.
![Installing Grafana for different Operating Systems]()
Installing Grafana on Windows
- Download Grafana: Visit the Grafana downloads page (https://grafana.com/grafana/download) and download the Windows installer for Grafana.
- Run the Installer: Once the download is complete, run the installer and follow the on-screen instructions to install Grafana on your Windows system.
- Start Grafana: After the installation is complete, you can start Grafana by clicking on the Grafana icon in the Start menu or by running the
grafana-server.exe executable in the Grafana installation directory.
- Access Grafana: Open your web browser and navigate to
http://localhost:3000 access the Grafana web interface. The default username and password are both admin.
- Configure Grafana (Optional): You can configure Grafana further by logging in with the default credentials and accessing the admin panel. From there, you can change the default password, configure data sources, and set up dashboards.
Installing Grafana on macOS
- Install Homebrew (Optional): If you have Homebrew installed, you can install Grafana using the following command:
curl -O https://dl.grafana.com/enterprise/release/grafana-enterprise-10.4.2.darwin-amd64.tar.gz
tar -zxvf grafana-enterprise-10.4.2.darwin-amd64.tar.gz
- Download Grafana: If you prefer not to use Homebrew, you can download the macOS installer for Grafana from the Grafana downloads page.
- Run the Installer: Once the download is complete, run the installer and follow the on-screen instructions to install Grafana on your macOS system.
- Start Grafana: After the installation is complete, you can start Grafana by running the following command in the terminal:
brew services start grafana
- Access Grafana: Open your web browser and navigate to
http://localhost:3000 to access the Grafana web interface. The default username and password are both admin.
Installing Grafana on Linux
- Download Grafana: Visit the Grafana downloads page and download the Linux package for Grafana. You can choose between
.deb (for Debian/Ubuntu) and .rpm (for Red Hat/CentOS) packages.
- Install Grafana: Install Grafana using the package manager for your Linux distribution. You can use the following commands
- Debian/Ubuntu,(64 Bit):
sudo apt-get install -y adduser libfontconfig1 musl
wget https://dl.grafana.com/enterprise/release/grafana-enterprise_10.4.2_amd64.deb
sudo dpkg -i grafana-enterprise_10.4.2_amd64.deb
- Standalone Linux Binaries(64 Bit)
wget https://dl.grafana.com/enterprise/release/grafana-enterprise-10.4.2.linux-amd64.tar.gz
tar -zxvf grafana-enterprise-10.4.2.linux-amd64.tar.gz
- Red Hat, CentOS, RHEL, and Fedora(64 Bit)
sudo yum install -y https://dl.grafana.com/enterprise/release/grafana-enterprise-10.4.2-1.x86_64.rpm
- OpenSUSE and SUSE(64 Bit)
wget https://dl.grafana.com/enterprise/release/grafana-enterprise-10.4.2-1.x86_64.rpm
sudo rpm -Uvh grafana-enterprise-10.4.2-1.x86_64.rpm
- Start Grafana: Start Grafana using the following command:
sudo service grafana-server start
-
Access Grafana: Open your web browser and navigate to http://localhost:3000 to access the Grafana web interface. The default username and password are both admin.
Installing Grafana on Docker
Grafana can also be easily installed and run using Docker, a popular containerization platform. Docker allows you to run applications in isolated environments called containers, which makes installing and managing Grafana simple and efficient. In this guide, we will provide you with a step-by-step guide to installing Grafana using Docker.
Prerequisites
Before you begin, ensure that you have Docker installed on your system. You can download and install Docker from the official Docker website (https://www.docker.com/get-started).
- Pull the Grafana Docker Image Open a terminal window and use the following command to pull the official Grafana Docker image from Docker Hub:
docker pull grafana/grafana
This command will download the latest version of the Grafana Docker image to your local machine.
![]()
-
Run Grafana as a Docker Container Once the image is downloaded, you can run Grafana as a Docker container using the following command:
-
Docker(Alpine base image) Lightweight Docker container image using an Alpine base image.
docker run -d --name=grafana -p 3000:3000 grafana/grafana-enterprise
![]()
-
Docker(Ubuntu base image) Alternative Docker container image for those who prefer an Ubuntu base image.
docker run -d --name=grafana -p 3000:3000 grafana/grafana-enterprise:10.4.2-ubuntu
- This command will start a new Docker container named "grafana" in detached mode (-d), expose port 3000 on the host machine (-p 3000:3000), and use the Grafana image (grafana/grafana). The Grafana web interface will be accessible at http://localhost:3000.
![]()
-
Access the Grafana Web Interface Open your web browser and navigate to http://localhost:3000 to access the Grafana web interface. You will be prompted to log in with the default username and password, which are both admin.
![]()
-
Configure Grafana (Optional) Once you have accessed the Grafana web interface, you can configure Grafana further by logging in with the default credentials. From there, you can change the default password, configure data sources, and set up dashboards.
-
Stop and Remove the Grafana Container (Optional) If you ever need to stop and remove the Grafana container, you can use the following commands:
docker stop grafana
docker rm grafana
![]()
Conclusion
Installing Grafana on different operating systems is a relatively simple process that can be completed in just a few steps. By following the instructions provided in this guide, you can quickly set up Grafana and start visualizing your metrics data.
Reference