Go modules · #2886 by repository stars

github.com/grafana/grafana-kiosk

v1.0.13grafana/grafana-kiosk ↗New releases in your daily digest, changelog included.

Last release 28 days ago
09 Sep 2026
Release timing varies
gaps range from 9 days to 13 months
Nearly every release is documented
notes for 14 of 14 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
30 releases · first in 2019

Release timeline

30 releases since 2019

20192020202120222023202420252026

Releases

v1.0.139 Sept 20263 sources agree
Add -headless flag (env KIOSK_HEADLESS , default false ) to run the browser without a display, for servers and CI pipelines with no attached screen
Features

Add -headless flag (env KIOSK_HEADLESS, default false) to run the browser without a display, for servers and CI pipelines with no attached screen (#279)

Add -disable-chromium-kiosk-optimizations flag (env KIOSK_DISABLE_CHROMIUM_KIOSK_OPTIMIZATIONS, default false) to opt out of kiosk-specific Chromium flags if they cause compatibility issues (#279)

Add Chrome flags for reliable kiosk operation: disable background timer throttling (keeps Grafana auto-refresh running when the window loses focus), disable hang monitor (suppresses "Page Unresponsive" dialogs), disable Safe Browsing updates, suppress telemetry uploads, allow drill-down popups (#279)

Add -restart-delay-ms flag (env KIOSK_RESTART_DELAY_MS, default 5000) to set the delay before automatically restarting after a session error; kiosk now recovers from browser crashes instead of exiting (#276)

Add -browser flag (env KIOSK_BROWSER, default chrome) to choose between Chrome and Microsoft Edge as the launched browser (#267)

Add -browser-path flag (env KIOSK_BROWSER_PATH) to point at an explicit Chromium-based browser executable; overrides -browser (#267)

Bug Fixes

Fix -browser-path being rejected at startup — an explicit browser path is now honored regardless of the -browser value, so any Chromium-based binary can be used (#277)

Fix silent Chrome fallback when Edge binary missing — startup now exits with a clear error message instead of silently launching Chrome when browser=edge is set but no Edge binary is found on PATH (#277)

Fix startup failures on slow or busy devices — the browser is now given 60 seconds instead of 20 to come up, so a cold start on hardware like a Raspberry Pi no longer aborts the session and forces a restart (#316)

Fix Azure AD login hanging on shutdown instead of exiting cleanly (#276)

Fix crashes during API key and ID token login — an error while intercepting requests would take down the whole kiosk process; these are now logged and the session continues (#276)

Fix Grafana Cloud login failing to submit the login form on some pages (#276)

Fix ID token login occasionally letting requests through without the configured token attached (#276)

Fix silent exits on bad config — startup validation failures now log a descriptive message with a fix suggestion before exiting (#276)

Speed up Azure AD and Grafana Cloud login by 3 seconds each — fixed delays replaced with waits that continue as soon as the page is ready (#260)

Tests

Add integration tests that run the kiosk against a real Grafana container (#279)

Add a browser abstraction so login provider flows can be unit tested (#260, #276)

CI/CD

Drop the coverage badge, whose publishing step failed on every push to main (#316)

Update k1LoW/octocov-action to v1.5.1 (#269)

Dependencies

Update chromedp to v0.16.0 and cdproto to the 2026-08-04 snapshot, picking up upstream Chrome DevTools Protocol fixes (#271, #312)

Update google.golang.org/api to v0.297.0 (#312)

Build with Go 1.27.1 (#312)

Update github.com/magefile/mage to v1.17.2 (#268)

Update transitive dependencies to their latest releases, including golang.org/x/crypto v0.56.0 (#312)

Documentation

Document the release process rule against leaving an empty [Unreleased] section (#270)

Fix the action-update procedure so correctly pinned actions no longer look stale (#316)

Chores

Reorganize login providers into dedicated sub-packages (#278)

New Contributors

@fdrstrok made their first contribution in #267

Full Changelog: v1.0.12...v1.0.13

One column per quarter.

Additional notes

v1.0.13 Latest

Latest

Compare

Choose a tag to compare

Open source →

v1.0.13-0.20260501202955-e428f326a1f51 May 2026pre-release

Nothing published for this version

v1.0.1229 Apr 2026

Add --incognito flag to optionally disable Chrome incognito mode

Features

Add --incognito flag to optionally disable Chrome incognito mode (#247)
Add --hide-logo flag to hide Powered by Grafana logo (#256)
Add --hide-playlist-nav flag to hide playlist navigation controls (#256)

Bug Fixes

Fix query errors with newer Grafana API (#254) — thanks @llamafilm!
Fix hideLogo query parameter to match Grafana's native format (#262)
Fix Grafana 12+ scenes viewport changes causing kiosk to not autofit panels (#250)
Fix fullscreen cycle for non-full kiosk modes (tv, disabled) (#251)
Fix HTTP URLs blocked by Chromium 130+ HTTPS-First Mode (#249)
Fix CLI flags not overriding config file values when using -c (#248)
Fix API key host prefix matching to prevent auth header leakage (#244)

CI/CD

Persist coverage badges, add actionlint, restrict workflow permissions (#246)
Add coverage badges to README (#245)

Dependencies

Update Go modules: chromedp/cdproto, magefile/mage, google.golang.org/api, golang.org/x/*, grpc, otel (#243)
Update actions/setup-go to v6.4.0 (#236)
Update google/osv-scanner-action to v2.3.5 (#235)
Update softprops/action-gh-release to v3 (#259)

Documentation

Rewrap AGENTS.md in agents-md behavioral template; split project detail into .agents/ topic files (#264)

New Contributors

@llamafilm made their first contribution in #254

Full Changelog: v1.0.11...v1.0.12

Open source →

Additional notes2 sources agree

Features

Add --incognito flag to optionally disable Chrome incognito mode (#127)
Add -hide-logo flag to hide Powered by Grafana logo (#240)
Add -hide-playlist-nav flag to hide playlist navigation controls (#240)
Update _dash.hideLinks, _dash.hideTimePicker, _dash.hideVariables query param values to match Grafana's native format
Add hide flags to startup config summary logging with visual section separators
Refactor summary() into logGeneralSettings, logTargetSettings, logGoAuthSettings

Bug Fixes

Fix Windows binary missing .exe suffix in Mage build output
Fix hideLogo query parameter from _dash.hideLogo to hideLogo to match Grafana's native format
Fix Grafana 12+ scenes viewport changes causing kiosk to not autofit panels (#177)
Fix cycleWindowToSize unconditionally cycling to fullscreen when kiosk mode is tv or disabled (#177)
Fix HTTP URLs blocked by Chromium 130+ HTTPS-First Mode (#155)
Fix CLI flags not overriding config file values when using -c (#210)
Fix API key host prefix matching to prevent auth header leakage to hosts sharing a prefix with the target
Fix broken badge images: push shields.io JSON endpoint to badges branch from CI, use shields.io dynamic badge in README
Fix query errors with newer Grafana API (#254)

Tests

Add tests for IsDataSourceQueryRequest and IsTargetHostRequest in apikey login
Add tests for sanitize in main and initialize packages
Add tests for GenerateURL playlist mode
Add tests for command allowlist in initialize package
Add tests for cycleWindowToSize, waitForPageLoad, and waitForBrowserStartup utilities
Add tests for loadConfig: malformed YAML, testdata fixtures, env var overrides, all CLI flag overrides (37.5% -> 82.5%)
Add tests for ProcessArgs with all CLI flags

CI/CD

Update actions/upload-artifact from v7 to v7.0.1 in CI workflow
Add octocov-action to CI for test coverage reporting on PRs
Add pull_request trigger to Build CI workflow
Save coverage report as CI artifact
Disable octocov PR comment, use PR body insertion only
Add octocov coverage badges to README
Restrict CI workflow permissions: global permissions: {} with job-level contents: write and pull-requests: write
Add actionlint job to CI for GitHub Actions workflow linting
Fix shellcheck warnings in CI workflow: quote variables, group redirects
Add markdownlint.yml workflow to lint .md files on push to main and PRs

Dependencies

Update Go module dependencies: chromedp/cdproto, magefile/mage v1.17.1, google.golang.org/api v0.275.0, golang.org/x/{crypto,net,sys,text}, google.golang.org/grpc v1.80.0, go.opentelemetry.io/otel v1.43.0, cloud.google.com/go/auth v0.20.0
Update Docker base images: golang 1.26.2-alpine, dtcooper/raspberrypi-os latest digest
Update actions/setup-go from v6.3.0 to v6.4.0 in CI workflow (#236)
Update google/osv-scanner-action to v2.3.5 in CI workflow (#235)
Update softprops/action-gh-release to v3 in CI workflow (#259)

Documentation

Expand README window-size/kiosk-mode section with Chrome launch flags, CDP cycling, and Grafana query parameter tables
Add 10 example YAML config files for dashboard/playlist, fullscreen/tv/windowed, and multi-monitor positioning
Fix long lines in README.md for MD013 compliance
Rewrap AGENTS.md around the agents-md behavioral template; split project-specific detail into topic files under .agents/ (build, code-style, readme-policy, ci, release)

Chores

Add CLAUDE.md referencing AGENTS.md
Update AGENTS.md action version table to match current CI pinned versions
Add MD013 (line length) and MD060 (aligned tables) rules to markdownlint config
Switch to markdownlint-cli2 with .markdownlint-cli2.yaml config
Add missing technical terms to cspell config
Replace CLAUDE.md include stub with symlink to AGENTS.md; add GEMINI.md symlink for cross-tool portability
Ignore CLAUDE.md and GEMINI.md symlinks in markdownlint config to avoid duplicate linting

Additional notes

v1.0.12

Compare

Choose a tag to compare

Open source →

v1.0.12-0.20260412053015-a30953e7532812 Apr 2026pre-release

Nothing published for this version

v1.0.1126 Mar 2026Deprecated

docs/fix: add branching policy, fix chromedp build, replace deprecated idtoken API by @briangann in #231

What's Changed

chore(deps): update actions/upload-artifact action to v5 by @renovate-sh-app[bot] in #190
chore(deps): update actions/stale action to v10 by @renovate-sh-app[bot] in #189
chore(deps): pin dependencies by @renovate-sh-app[bot] in #191
chore(deps): update module golang.org/x/crypto to v0.45.0 [security] by @renovate-sh-app[bot] in #200
Fix temp dir cleanup not running when process receives a signal by @nightio in #212
chore(deps): update golang docker tag to v1.26 by @renovate-sh-app[bot] in #213
Add Content-Type header to host requests by @bramalho in #208
chore(deps): update jwalton/gh-find-current-pr action to v1.3.5 by @renovate-sh-app[bot] in #215
chore(deps): update google/osv-scanner-action action to v2.3.3 by @renovate-sh-app[bot] in #206
chore(deps): update securego/gosec action to v2.24.7 by @renovate-sh-app[bot] in #205
chore(deps): update golangci/golangci-lint-action action to v9 by @renovate-sh-app[bot] in #196
chore(deps): update actions/upload-artifact action to v7 by @renovate-sh-app[bot] in #218
chore(deps): update actions/checkout action to v6 by @renovate-sh-app[bot] in #217
fix(deps): update module github.com/magefile/mage to v1.16.1 by @renovate-sh-app[bot] in #216
chore(deps): update actions/stale digest to b5d41d4 by @renovate-sh-app[bot] in #204
Fix Environment Variables Not Working with Command-Line Arguments by @mcder0015 in #199
Disable kiosk/fullscreen when explicit window size is requested by @nightio in #194
Fix gosec security violations in lxde.go and main.go by @briangann in #219
Add AzureAD authentication support by @briangann in #220
Fix apikey login for Grafana Cloud: remove stale WaitVisible and incorrect Content-Type by @eltondeboer in #222
chore(deps): update softprops/action-gh-release action to v2.6.0 by @renovate-sh-app[bot] in #221
chore(deps): update module google.golang.org/grpc to v1.79.3 [security] by @renovate-sh-app[bot] in #223
chore(deps): update softprops/action-gh-release action to v2.6.1 by @renovate-sh-app[bot] in #224
fix(deps): update module github.com/chromedp/chromedp to v0.15.0 by @renovate-sh-app[bot] in #230
chore(deps): update securego/gosec action to v2.25.0 by @renovate-sh-app[bot] in #228
chore(deps): update magefile/mage-action action to v4 by @renovate-sh-app[bot] in #227
fix(deps): update github.com/chromedp/cdproto digest to e3e3800 by @renovate-sh-app[bot] in #229
fix(deps): update module google.golang.org/api to v0.272.0 by @renovate-sh-app[bot] in #225
docs/fix: add branching policy, fix chromedp build, replace deprecated idtoken API by @briangann in #231
fix(deps): update mage to v1.17.0 and google.golang.org/api to v0.273.0 by @briangann in #232
chore(ci): add workflow_dispatch trigger to Build workflow by @briangann in #233
test: add tests for generateExecutorOptions by @briangann in #234

New Contributors

@renovate-sh-app[bot] made their first contribution in #190
@nightio made their first contribution in #212
@bramalho made their first contribution in #208
@mcder0015 made their first contribution in #199
@eltondeboer made their first contribution in #222

Full Changelog: v1.0.10...v1.0.11

Open source →

Additional notes2 sources agree

Add AzureAD authentication support for kiosk mode (#211)
Fix gosec security violations: add command allowlist in LXDE init, sanitize log inputs (#219)
Update all Go module dependencies to latest versions (#214)
Disable kiosk/fullscreen when explicit window size is requested (#194)
Fix environment variables not working with command-line arguments (#199)
Fix temp dir cleanup not running when process receives a signal (#212)
Add Content-Type header to host requests (#208)
Upgrade Go version to 1.26.1
Add AGENTS.md with build, test, lint, and code style guidelines
Add branching policy and contribution guidelines to AGENTS.md (#231)
Update chromedp to v0.15.1 to fix build compatibility (#231)
Replace deprecated idtoken.WithCredentialsFile with option.WithAuthCredentialsFile (#231)
Update mage to v1.17.0 and google.golang.org/api to v0.273.0 (#232)
Fix KIOSK_LOGIN_METHOD env-description to include aws (#232)
Update README usage documentation (CLI flags and environment variables) from actual --help output (#232)
Add README update procedure to AGENTS.md (#232)
Add changelog policy to AGENTS.md (#232)
Update actions/setup-go from v6 to v6.3.0 in CI workflow (#232)
Add GitHub Actions update procedure to AGENTS.md (#232)
Add workflow_dispatch trigger to Build CI workflow
Add release process documentation to AGENTS.md
Add explicit markdownlint requirement for AGENTS.md to formatting guidelines
Add tests for generateExecutorOptions in utils.go (#234)
Add README review policy to AGENTS.md (#234)
Fix apikey login for Grafana Cloud: remove stale WaitVisible and incorrect Content-Type (#222)

Additional notes

v1.0.11

Compare

Choose a tag to compare

Open source →

v1.0.11-0.20251030234254-de02bc67bfb630 Oct 2025pre-release

Nothing published for this version

v1.0.11-0.20251030152311-c86c51630a5530 Oct 2025pre-release

Nothing published for this version

v1.0.1030 Oct 2025

README: Fix typos in playlist by @unbelauscht in #167

What's Changed

README: Fix typos in playlist by @unbelauscht in #167
Accept cookies for AWS grafana automatically by @Lutger in #170
Feature: implement handling of dash parameters to hide variables, timepicker and links by @pkeuter in #174
Click "Yes" in "Stay signed in" page when using Microsoft login by @PhilipGeil in #175
Changed Systemd stage to network-online.target by @aseques in #179
Fix keyring prompt and update packages by @briangann in #188

New Contributors

@unbelauscht made their first contribution in #167
@Lutger made their first contribution in #170
@pkeuter made their first contribution in #174
@PhilipGeil made their first contribution in #175
@aseques made their first contribution in #179

Full Changelog: v1.0.9...v1.0.10

Open source →

Additional notes2 sources agree

Fix for issue [[#187]]
Updates go packages

Open source →

Additional notes

v1.0.10

Compare

Choose a tag to compare

Open source →

v1.0.927 Sept 2024

fix: bypass login for oauth is not reliables by @briangann in #148

What's Changed

fix: bypass login for oauth is not reliables by @briangann in #148
Fix run:local and build:local Mage targets on Linux and Windows by @xnyo in #163
Fix: Pass Authorization header only to Grafana when using apikey auth by @xnyo in #162
Ability for 'goauth' to handle the situation if the password field isn't visible on the first screen (or might be visible but breaks the flow) by @nboeckmann in #153
Add some rough but functional Docker support by @slim-bean in #154
update packages and bugfixes by @briangann in #164

New Contributors

@xnyo made their first contribution in #163
@nboeckmann made their first contribution in #153
@slim-bean made their first contribution in #154

Full Changelog: v1.0.8...v1.0.9

Open source →

Additional notes2 sources agree

Fix for issue [#159]
Fix for issue [#160]
Updates go packages
Please note: When using a service account token, you may need to increase the delay in your configuration for playlists depending on the device being used (10000 ms for RPi4b appears stable)

Open source →

Additional notes

v1.0.9

Compare

Choose a tag to compare

Open source →

v1.0.9-0.20241002033033-19dc76d94bf72 Oct 2024pre-release

Nothing published for this version

v1.0.9-0.20240927022355-1271471255fd27 Sept 2024pre-release

Nothing published for this version

v1.0.823 Sept 2024

Fix "choose your search engine" pop-up by @LarsStegman in #138

What's Changed

Fix "choose your search engine" pop-up by @LarsStegman in #138
Fix passing of scale factor by @maximoei in #142
update modules and workflow by @briangann in #143

New Contributors

@LarsStegman made their first contribution in #138
@maximoei made their first contribution in #142

Full Changelog: v1.0.7...v1.0.8

Open source →

Additional notes2 sources agree

Fix for issue #137 How to get rid of "Choose your search engine" window
Fix for scale-factor parameter #142

Open source →

Additional notes

v1.0.8

Compare

Choose a tag to compare

Open source →

v1.0.8-0.20240923022608-3ee7b0d629ec23 Sept 2024pre-release

Nothing published for this version

v1.0.731 May 2024

AzureAD Auto-Login Local Override by @friedpope in #107

What's Changed

AzureAD Auto-Login Local Override by @friedpope in #107
Set flag to disable translator overlay by @ProfKnox in #113
20231129 fix build by @briangann in #118
updating for scaling by @wizardofdevops in #120
update workflow and go package versions by @briangann in #121
fix spelling "Launching" by @to-s in #128
Feature additions by @briangann in #122
fixes gcom login hang by @briangann in #133

New Contributors

@friedpope made their first contribution in #107
@ProfKnox made their first contribution in #113
@wizardofdevops made their first contribution in #120
@to-s made their first contribution in #128

Full Changelog: v1.0.6...v1.0.7

Open source →

Additional notes2 sources agree

Fix for GCOM login Issue #132
Update go modules

Open source →

Additional notes

v1.0.7

Compare

Choose a tag to compare

Open source →

v1.0.7-0.20240531022912-d1212b89e8af31 May 2024pre-release

Nothing published for this version

v1.0.7-0.20240518015557-3be3d4cfc66f18 May 2024pre-release

Nothing published for this version

v1.0.7-0.20240307040142-33326c959aa17 Mar 2024pre-release

Nothing published for this version

v1.0.7-0.20231129145956-0c0f540a350329 Nov 2023pre-release

Nothing published for this version

v1.0.7-0.20230308053015-821852ebe2358 Mar 2023pre-release

Nothing published for this version

v1.0.68 Mar 2023

markdown lint by @briangann in #18

What's Changed

markdown lint by @briangann in #18
Convert to go mod by @briangann in #20
update docs by @briangann in #21
new docs for autostarting kiosk as a service/background process by @briangann in #22
Fix login local by @AlexHeylin in #34
Add an option to ignore certificate errors by @xanmanning in #26
update to go 1.14 and modules to prevent crash in v7 by @briangann in #35
use git lfs by @briangann in #36
add generic oauth login by @mistadave in #47
linting fixes, upgrade modules by @briangann in #53
Updates for v1.0.3 by @briangann in #54
chore: add codeclimate by @briangann in #56
fix circle step ordering by @briangann in #58
add submit button click to gcom login steps by @roketworks in #84
Update chromedp to v0.8.5 by @siimjuuse in #82
Validate login method by @siimjuuse in #81
update packages by @briangann in #85
Idtoken Service Account auth by @marcusramberg in #75
20221012 fix login method check by @briangann in #86
fix duplicate yaml config key by @briangann in #87
fix paths for release and excludes by @briangann in #89
Add an example on how to disable screensaver and monitor standby in the systemd service description. by @penguineer in #91
switch to mage and git workflows by @briangann in #100
Adds support for Grafana API key Auth by @ronansalmon in #93
Update README.md - example config by @0xUnicorn in #95
feat: add the ability to set window-size by @gaetanars in #101
add autoplay-policy option to chromedp flags by @legnoh in #99
feat: add support for aws managed grafana by @pkarakal in #96
Adds UserAgent and CPU Usage optimization by @briangann in #102
fix autofit logic by @briangann in #103
Switch to deep checkout needed for release action by @penguineer in #104
fix client version by @briangann in #105

New Contributors

@AlexHeylin made their first contribution in #34
@xanmanning made their first contribution in #26
@mistadave made their first contribution in #47
@roketworks made their first contribution in #84
@siimjuuse made their first contribution in #82
@marcusramberg made their first contribution in #75
@penguineer made their first contribution in #91
@ronansalmon made their first contribution in #93
@0xUnicorn made their first contribution in #95
@gaetanars made their first contribution in #101
@legnoh made their first contribution in #99
@pkarakal made their first contribution in #96

Full Changelog: v1.0.0...v1.0.6

Open source →

Additional notes2 sources agree

Includes PR#93 - adds authentication with API Key!
Reduces app CPU utilization to near zero while running
Adds version to build based on git tag
Adds user agent with kiosk version
Switch to git workflow for builds
Switch to Mage for building instead of make
Update go modules

Open source →

Additional notes

v1.0.6

Compare

Choose a tag to compare

Open source →

v1.0.512 Oct 20223 sources agree

Update go modules to fix continuous error messages

Update go modules to fix continuous error messages
Updated linters and circleci config for go 1.19
Adds support for Google IAP Auth (idtoken)
Fixes GCOM auth login hanging

Open source →

Additional notes

grafana-kiosk v1.0.5

Compare

Choose a tag to compare

Open source →

v1.0.429 Jun 20213 sources agree

Fix startup issue with new flags

Fix startup issue with new flags

Open source →

Additional notes

grafana-kiosk v1.0.4

Compare

Choose a tag to compare

Open source →

v1.0.329 Jun 20213 sources agree

Added "window-position" option, allows running kiosk on different displays

OAuth merged
Fix Grafana Cloud login
Updated modules
Added "window-position" option, allows running kiosk on different displays
Added --check-for-update-interval=31536000 to default flags sent to chromium to workaround update popup

Open source →

Additional notes

grafana-kiosk v1.0.3

Compare