How to host Grafana on your own server
Grafana draws dashboards from your data sources. Zefily installs it as a container behind HTTPS. Its admin password is set at its first start, so the panel's temporary login opens Grafana too, and you can change it afterwards.
Before you start
- A server connected to Zefily with the web stack installed.
- A domain whose DNS points to the server.
- The data source your dashboards read from, such as a database or a metrics service.
Steps
-
1. Install from One-click apps
Open the server, choose Sites, pick Grafana under One-click apps, enter the domain, keep HTTPS on and click Install.
-
2. Read the temporary password
Click Show admin login on the site. The user name is admin, and the password is the site temporary access password.
-
3. Sign in and change the password
That password becomes the Grafana admin password at its first start, so one login opens both. After the first sign-in, change it in Grafana if you want your own.
-
4. Add a data source
In Grafana open Connections, then Data sources, and add the database or metrics service your dashboards read from. Use the test button there to confirm the server can reach it.
-
5. Build a dashboard
Create a dashboard, add a panel for each query and save it. Dashboards are stored in the Grafana data folder on the server.
-
6. Keep it updated
Deploy now pulls the newest image. When the catalog moves Grafana to a newer pinned image, the Update option appears; it asks before it stops the site.
-
7. Add the site to a backup plan
Add the site to a backup plan before you update. A new version may migrate the data.
Verify it works
Open the domain: the Grafana sign-in screen loads over HTTPS. Sign in as admin, open the home dashboard, and check that a panel from your data source shows data.
Troubleshooting
- The temporary password does not work
- If you changed the password in Grafana, use the new one. The panel value only applies at the first start, so it no longer works after you change it.
- A panel shows no data
- Test the data source under Connections, then Data sources, and check that the server can reach the database or the service.
- An update stopped the site
- Updates stop the site and copy its data to ~/backups when it fits. Check that the server has room for the copy and that the backup plan covers the site.
Questions
Which login opens Grafana?
The user admin and the password from Show admin login, until you change the password in Grafana.
Can my team sign in too?
Yes. Grafana has its own users and roles. Add the team members inside Grafana.
Is my data kept when I update?
Yes, the data folder is kept across updates. A new version can still migrate it, so back up first.
Read next
Start on a server you own
Create your account, connect a server and follow the guide. The server stays yours: you pay your provider.