mirror of
https://github.com/grafana/grafana.git
synced 2025-07-28 12:22:25 +08:00
80 lines
2.8 KiB
Markdown
80 lines
2.8 KiB
Markdown
---
|
|
headless: true
|
|
labels:
|
|
products:
|
|
- enterprise
|
|
- oss
|
|
title: Back up Grafana
|
|
---
|
|
|
|
# Back up Grafana
|
|
|
|
This topic explains how to back up a local Grafana deployment, including configuration, plugin data, and the Grafana database.
|
|
|
|
## Back up the Grafana configuration file
|
|
|
|
Copy Grafana configuration files that you might have modified in your Grafana deployment to a backup directory.
|
|
|
|
The Grafana configuration files are located in the following directories:
|
|
|
|
- Default configuration: `$WORKING_DIR/defaults.ini` (Don't change this file)
|
|
- Custom configuration: `$WORKING_DIR/custom.ini`
|
|
|
|
For more information on where to find configuration files, refer to [Configuration file location](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/setup-grafana/configure-grafana/#configuration-file-location).
|
|
|
|
{{< admonition type="note" >}}
|
|
If you installed Grafana using the `deb` or `rpm` packages, then your configuration file is located at
|
|
`/etc/grafana/grafana.ini`. This path is specified in the Grafana `init.d` script using `--config` file parameter.
|
|
{{< /admonition >}}
|
|
|
|
## Back up plugin data
|
|
|
|
Installing plugins in Grafana creates a folder for each plugin with its associated files and data. Copy all files and folders recursively from this location to your backup repository.
|
|
|
|
The Grafana plugin files are located in the following directories:
|
|
|
|
- Default location for plugins in a binary or source installation: `$WORKING_DIR/data/plugins`
|
|
- Default location for plugins in a `deb` or `rpm` package: `/var/lib/grafana/plugins`. This path is specified in the Grafana init.d script using `--config` file parameter.
|
|
|
|
## Back up the Grafana database
|
|
|
|
We recommend that you back up your Grafana database so that you can roll back to a previous version, if required.
|
|
|
|
### SQLite
|
|
|
|
The default Grafana database is SQLite, which stores its data in a single file on disk. To back up this file, copy it to your backup repository.
|
|
|
|
{{< admonition type="note" >}}
|
|
To ensure data integrity, shut down your Grafana service before backing up the SQLite database.
|
|
{{< /admonition >}}
|
|
|
|
The SQLite database file is located in one of the following directories:
|
|
|
|
- Default location for SQLite data in a binary or source installation: `$WORKING_DIR/data/grafana.db`
|
|
- Default location for SQLite data in a `deb` or `rpm` package: `/var/lib/grafana/grafana.db`. This path is specified in the Grafana
|
|
init.d script using `--config` file parameter.
|
|
|
|
### MySQL
|
|
|
|
To back up or restore a MySQL Grafana database, run the following commands:
|
|
|
|
```bash
|
|
backup:
|
|
> mysqldump -u root -p[root_password] [grafana] > grafana_backup.sql
|
|
|
|
restore:
|
|
> mysql -u root -p grafana < grafana_backup.sql
|
|
```
|
|
|
|
### Postgres
|
|
|
|
To back up or restore a Postgres Grafana database, run the following commands:
|
|
|
|
```bash
|
|
backup:
|
|
> pg_dump grafana > grafana_backup
|
|
|
|
restore:
|
|
> psql grafana < grafana_backup
|
|
```
|