An open API service indexing awesome lists of open source software.

https://github.com/daemonless/grafana


https://github.com/daemonless/grafana

Last synced: 3 days ago
JSON representation

Awesome Lists containing this project

README

          

# Grafana

[![Build Status](https://img.shields.io/github/actions/workflow/status/daemonless/grafana/build.yaml?style=flat-square&label=Build&color=green)](https://github.com/daemonless/grafana/actions)
[![Last Commit](https://img.shields.io/github/last-commit/daemonless/grafana?style=flat-square&label=Last+Commit&color=blue)](https://github.com/daemonless/grafana/commits)

Grafana is an open source and composable observability and data visualization platform. Visualize metrics, logs, and traces from multiple sources like Prometheus, Loki, Elasticsearch, InfluxDB, Postgres and many more.

| | |
|---|---|
| **Port** | 3000 |
| **Registry** | `ghcr.io/daemonless/grafana` |
| **Source** | [https://github.com/grafana/grafana](https://github.com/grafana/grafana) |
| **Website** | [https://grafana.com/grafana/](https://grafana.com/grafana/) |

## Version Tags

| Tag | Description | Best For |
| :--- | :--- | :--- |
| `latest` / `pkg` | Installed from the FreeBSD quarterly package repository. | Most users. Matches Linux Docker behavior. |
| `pkg-latest` | Installed from the FreeBSD latest package repository. | Alternative build. |

## Prerequisites

Before deploying, ensure your host environment is ready. See the [Quick Start Guide](https://daemonless.io/guides/quick-start) for host setup instructions.

## Deployment

### Podman Compose

```yaml
services:
grafana:
image: "ghcr.io/daemonless/grafana:latest"
container_name: grafana
environment:
- PUID=1000 # User ID for the application process
- PGID=1000 # Group ID for the application process
- TZ=UTC # Timezone for the container
volumes:
- "/path/to/containers/grafana:/config"
ports:
- "3000:3000"
restart: unless-stopped
```

### AppJail Director

**.env**:

```
DIRECTOR_PROJECT=grafana
PUID=1000
PGID=1000
TZ=UTC
```

**appjail-director.yml**:

```yaml
options:
- virtualnet: ': default'
- nat:
services:
grafana:
name: grafana
options:
- container: 'boot args:--pull'
oci:
user: root
environment:
- PUID: !ENV '${PUID}'
- PGID: !ENV '${PGID}'
- TZ: !ENV '${TZ}'
volumes:
- grafana: /config
volumes:
grafana:
device: '/path/to/containers/grafana'
```

**Makejail**:

```
ARG tag=latest

OPTION overwrite=force
OPTION from=ghcr.io/daemonless/grafana:${tag}
```

### Podman CLI

```bash
podman run -d --name grafana \
-p 3000:3000 \
-e PUID=1000 \
-e PGID=1000 \
-e TZ=UTC \
-v /path/to/containers/grafana:/config \
ghcr.io/daemonless/grafana:latest
```

### Ansible

```yaml
- name: Deploy grafana
containers.podman.podman_container:
name: grafana
image: "ghcr.io/daemonless/grafana:latest"
state: started
restart_policy: always
env:
PUID: "1000"
PGID: "1000"
TZ: "UTC"
ports:
- "3000:3000"
volumes:
- "/path/to/containers/grafana:/config"
```

Access at: `http://localhost:3000`

## Parameters

### Environment Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `PUID` | `1000` | User ID for the application process |
| `PGID` | `1000` | Group ID for the application process |
| `TZ` | `UTC` | Timezone for the container |

### Volumes

| Path | Description |
|------|-------------|
| `/config` | Configuration, data, logs, plugins and provisioning |

### Ports

| Port | Protocol | Description |
|------|----------|-------------|
| `3000` | TCP | Web UI |

**Architectures:** amd64
**User:** `bsd` (UID/GID via PUID/PGID, defaults to 1000:1000)
**Base:** FreeBSD 15.0

---

Need help? Join our [Discord](https://discord.gg/Kb9tkhecZT) community.