Grafana service fails to start on Windows

Check Event Viewer and Grafana logs for errors, verify port conflicts, and ensure permissions and correct paths. Try starting the service manually and review output.

Port 3000 is already in use

Find the process using port 3000 and stop it, or change Grafana's port and update Windows Firewall rules accordingly.

Can't log in / forgot admin password

Reset the admin password via configuration or environment variable, then restart the Grafana service. Secure the instance after login.

Plugins break after upgrade

Update or remove incompatible plugins, review release notes, and rollback if needed using your backup.

Common Errors — Grafana on Windows: Service, Port 3000, Firewall, Reverse Proxy, MSI

Q: 404/502 behind reverse proxy

Verify reverse proxy configuration (IIS/NGINX), HTTPS, headers, and Grafana's root_url if needed. Check firewall rules on port 443 and internal proxy to Grafana's port.

Q: MSI installation fails

Run the MSI as Administrator, check the verbose MSI log, ensure architecture matches (x64), and temporarily disable conflicting security tools if necessary.

Quick diagnosis checklist

Check the Windows service state and Event Viewer.
Verify the listening port and conflicts.
Review logs for errors after last action (install/upgrade).
Confirm firewall and reverse proxy scope.

Service fails to start

Get-Service grafana

sc.exe query grafana

Check Event Viewer → Windows Logs → Application/System.
Ensure the executable and config paths are correct.
Verify permissions for the service account (if not Local System).

See: Install as Service

Port 3000 in use / cannot bind

netstat -ano | findstr :3000

tasklist /FI "PID eq <PID>"

Stop or reconfigure the conflicting process, or change Grafana's port.
Update Windows Firewall rules after port change.

See: Windows Firewall

404/502 behind reverse proxy (IIS/NGINX)

Check proxy target (localhost:3000) and headers (Host/X-Forwarded-For/Proto).
Ensure HTTPS terminates at proxy and open firewall on 443 (Private/Domain).
Review Grafana configuration for public URL if needed.

MSI installation fails

msiexec /i "C:\\path\\to\\grafana-x64.msi" /L*v "%TEMP%\\grafana_install.log"

Run as Administrator and ensure x64 architecture.
Inspect the MSI log for error codes.
Temporarily disable security software if it interferes.

Signature invalid / SmartScreen warning

Re-download from the official site and verify the digital signature (Publisher: Grafana Labs).
Corporate proxies/AV may modify downloads; verify checksums and distribution chain.

Can't log in / reset admin password

Reset via environment variable (temporary) or config, then restart the service.

setx GF_SECURITY_ADMIN_PASSWORD "NewStrongPassword123!"

Restart-Service grafana

Remove the variable or update config after login to avoid leaving credentials in environment.

Permissions / access denied

If using a custom service account, grant Log on as a service and file read rights.
Fix folder permissions for data/logs if needed.

icacls "C:\\Program Files\\GrafanaLabs\\grafana" /grant <DOMAIN\User>:R /T

Plugins incompatible after upgrade

Remove or update the offending plugin and review release notes.
Rollback to previous version if critical; restore from backup.

Uninstall leaves service entry

sc.exe delete grafana

Then reinstall cleanly if needed.

Common errors & quick fixes (Windows)