Installation¶

This guide covers installing the Micromegas Grafana datasource plugin.

Prerequisites¶

Grafana: Version 9.0 or later
Micromegas Analytics Server: flight-sql-srv running and accessible
Authentication Credentials: API key or OAuth 2.0 client credentials

Installation Methods¶

Option 1: From Release (Recommended)¶

Download the latest plugin release from GitHub:

wget https://github.com/madesroches/micromegas/releases/download/grafana-vX.Y.Z/micromegas-micromegas-datasource-X.Y.Z.zip

Extract to your Grafana plugins directory:

# Default plugin directory
unzip micromegas-micromegas-datasource-X.Y.Z.zip -d /var/lib/grafana/plugins/

# Or custom plugin directory
unzip micromegas-micromegas-datasource-X.Y.Z.zip -d /path/to/grafana/plugins/

Set proper permissions:

chown -R grafana:grafana /var/lib/grafana/plugins/micromegas-micromegas-datasource

Restart Grafana:

# Systemd
sudo systemctl restart grafana-server

# Docker
docker restart grafana

Verify installation:
Navigate to Configuration → Plugins in Grafana
Search for "Micromegas"
Plugin should appear in the list

Option 2: Build from Source¶

Development Setup

This method is recommended for development or if you need to customize the plugin.

Clone the repository:

git clone https://github.com/madesroches/micromegas.git
cd micromegas/grafana

Install dependencies:
```
yarn install
```

Build the plugin:

# Production build
yarn build

# Development build with watch mode
yarn dev

Build backend binaries (Go):
```
mage -v build
```

Link plugin to Grafana:

# Create symlink in Grafana plugins directory
ln -s $(pwd) /var/lib/grafana/plugins/micromegas-micromegas-datasource

Restart Grafana (see commands above)

For detailed development instructions, see DEVELOPMENT.md.

Option 3: Docker with Plugin¶

If running Grafana in Docker, mount the plugin directory:

# docker-compose.yml
version: '3'
services:
  grafana:
    image: grafana/grafana:latest
    ports:
      - "3000:3000"
    volumes:
      - ./micromegas-micromegas-datasource:/var/lib/grafana/plugins/micromegas-micromegas-datasource
    environment:
      - GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=micromegas-micromegas-datasource

Unsigned Plugin

During development, you may need to allow unsigned plugins with:

GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=micromegas-micromegas-datasource

Verify Installation¶

Open Grafana (default: http://localhost:3000)
Navigate to Configuration → Plugins
Search for "Micromegas"
Plugin should be listed as installed

Next Steps¶

Once installed: