Download Images

Get a ready-to-flash SD card image with the Waveshare 8-DSI-TOUCH-A display pre-configured.

Tip

Pre-built images are the fastest way to get started. Custom builds let you set your preferences.

Pre-built Images

✓ SD Writer Active — Write directly to your SD card from the browser!

⌨️

Lite (64-bit)

Headless, no desktop

Perfect for kiosks, embedded systems, and headless displays.

• Raspberry Pi 5, 4, 3 (64-bit)
• ~600 MB download
• ~2 GB on SD card

🍓 Open in RPi Imager 💾 Write to SD Card ⬇️ Download .img.xz

🖥️

Desktop (64-bit)

Full GUI with Wayland

Full desktop experience with touch-optimized settings.

• Raspberry Pi 5, 4 (64-bit)
• ~1.8 GB download
• ~4.5 GB on SD card

🍓 Open in RPi Imager 💾 Write to SD Card ⬇️ Download .img.xz

32-bit Images (Pi 3, older Pi 4)

⌨️

Lite (32-bit)

For Raspberry Pi 3 and older systems.

🍓 RPi Imager ⬇️ Download

×

Select SD Card

Confirm Write

Writing Image...

Write Complete!

Error

Select the SD card to write to:

No removable drives detected. Insert an SD card and refresh.

Refresh Continue

⚠️ Warning

All data on will be erased!

Image:

Target:

Back Erase & Write

✅ Image written successfully!

You can now safely remove the SD card and boot your Raspberry Pi.

Done

Try Again Close

---

Custom Image Builder

Build a custom image with your specific settings pre-configured. Perfect for deploying multiple devices with consistent configuration.

Image Type Lite (headless) Desktop (GUI) Lite is recommended for kiosks and embedded use

Architecture 64-bit (Pi 5, Pi 4, Pi 3 64-bit) 32-bit (Pi 3, older Pi 4)

Display Rotation 0° (Landscape) 90° (Portrait, rotated right) 180° (Landscape, upside down) 270° (Portrait, rotated left)

Hostname Lowercase letters, numbers, and hyphens only

Timezone Eastern (New York) Central (Chicago) Mountain (Denver) Pacific (Los Angeles) Arizona (Phoenix) UK (London) Central Europe (Paris) Germany (Berlin) Japan (Tokyo) China (Shanghai) Australia (Sydney) UTC

WiFi Country United States United Kingdom Germany France Japan China Australia Canada Sets regulatory domain for WiFi frequencies

Build Custom Image Building...

Build Status

Build ID:

Status:

Stage:

Download Image

SHA256:

---

Flashing Options

Raspberry Pi Imager

Click “Open in RPi Imager” on any image above. The imager will launch with the Waveshare image pre-selected.

1. Install Raspberry Pi Imager
2. Click the imager button on any image
3. Select your SD card
4. Click Write

Note

This uses the rpi-imager: URL scheme which requires Raspberry Pi Imager to be installed.

imgflash (Browser SD Writer)

For direct browser-to-SD writing without additional software:

1. Download and run imgflash:

   # Download from releases (pre-built binary)
   curl -LO https://github.com/supported-systems/imgflash/releases/latest/download/imgflash-linux-x86_64
   chmod +x imgflash-linux-x86_64
   sudo ./imgflash-linux-x86_64
   
   # Or build from source (requires Rust 1.70+)
   cargo install --git https://github.com/supported-systems/imgflash
   sudo imgflash

2. Refresh this page — you’ll see a green banner and “Write to SD Card” buttons

3. Click write, select your SD card, confirm

imgflash is a universal disk imaging tool that supports SD cards, USB drives, HDDs, and even CD/DVD burning. Learn more about imgflash →

Caution

imgflash requires administrator/root privileges to write directly to block devices.

Manual Download

Download the .img.xz file and flash manually:

Using balenaEtcher:

1. Download balenaEtcher
2. Select the downloaded .img.xz file (no extraction needed)
3. Select your SD card
4. Click Flash

Using command line:

# Extract and write (Linux/macOS)
xzcat waveshare-8dsi-*.img.xz | sudo dd of=/dev/sdX bs=4M status=progress

# Or use bmaptool for faster flashing
bmaptool copy waveshare-8dsi-*.img.xz /dev/sdX

---

What’s Included

Every image includes:

• Latest Raspberry Pi OS (Bookworm)
• Pre-configured config.txt with DSI overlay
• Touch calibration udev rules
• Brightness control tool (waveshare-brightness)
• SSH enabled (default user: pi)

View Configuration Reference See exactly what settings are applied to each image