Raspberry Pi Guide
This guide walks you through setting up a Raspberry Pi with a small screen to run Glucogaze as a dedicated Nightscout display. You’ll create a simple, always-on display for your Nightscout data that’s easy to view at a glimpse, whether on a desk, bedside table, or wall-mounted screen.
This user guide walks you through setting up a dedicated Nightscout display on a Raspberry Pi. The setup has only been tested on Raspberry Pi. While it may work on other single-board computers, this is not guaranteed. Future guides may cover additional devices.
What you need
- Raspberry Pi (3, 4, or 5 recommended)
- MicroSD card (8 GB or more)
- Display (HDMI or official 3.5" / 5" touchscreen)
- Power supply
- Optional keyboard/mouse for setup
Raspberry Pi Guide
This guide walks you through setting up a Raspberry Pi with a small screen to run Glucogaze as a dedicated Nightscout display. You’ll create a simple, always-on display for your Nightscout data that’s easy to view at a glimpse, whether on a desk, bedside table, or wall-mounted screen.
Compatible Screens
| Screen Information | Resolution | GPIO | Tested | Actions |
|---|---|---|---|---|
| 480x320 | ||||
| 480x320 |
Nightscout Hosting Options
This guide walks you through setting up a Raspberry Pi with a small screen to run Glucogaze as a dedicated Nightscout display. You’ll create a simple, always-on display for your Nightscout data that’s easy to view at a glimpse, whether on a desk, bedside table, or wall-mounted screen.
1. Managed Nightscout Hosting
On the Pi, open the Glucogaze app, go to Settings, and enter your Nightscout URL and API token (if required). The display will then show your live data. Theme and layout can be adjusted in the app’s theme/layout settings.
To run Nightscout on the same Pi, see the official guide for building Nightscout on Raspberry Pi. You can then use http://localhost (or your Pi’s IP) as the Nightscout URL in Glucogaze.
Troubleshooting
- Blank or “No data” — Check Nightscout URL and token, and that the Pi can reach the Nightscout site (test in Chromium).
- Wrong resolution — Use the Raspberry Pi display/HDMI settings to set the correct resolution for your screen.
- Touch not working — For official small touchscreens, follow Raspberry Pi’s display and touch setup docs.
2. Self-Hosted Nightscout
On the Pi, open the Glucogaze app, go to Settings, and enter your Nightscout URL and API token (if required). The display will then show your live data. Theme and layout can be adjusted in the app’s theme/layout settings.
To run Nightscout on the same Pi, see the official guide for building Nightscout on Raspberry Pi. You can then use http://localhost (or your Pi’s IP) as the Nightscout URL in Glucogaze.
Troubleshooting
- Blank or “No data” — Check Nightscout URL and token, and that the Pi can reach the Nightscout site (test in Chromium).
- Wrong resolution — Use the Raspberry Pi display/HDMI settings to set the correct resolution for your screen.
- Touch not working — For official small touchscreens, follow Raspberry Pi’s display and touch setup docs.