Setup guide

Host your music. Own it.

Get your music node live in under 10 minutes. No technical expertise required.

What you need

  • ✓Raspberry Pi 4 (2GB RAM minimum, 4GB recommended)
  • ✓microSD card 16GB+ (Class 10 / A1 or faster)
  • ✓Power supply (official Pi power supply recommended)
  • ✓Broadband internet connection
  • ✓Your music files (MP3, FLAC, AAC, OGG supported)

Setup steps

1

Download the DizyFi Pi image

Download the latest DizyFi OS image. This is a customised Raspberry Pi OS Lite with the DizyFi node pre-installed and auto-configured.

Image size: ~1.2 GB — SHA256 checksum provided on the download page.
2

Flash the image to your SD card

Use Raspberry Pi Imager (recommended) or dd on Linux/macOS.

# Linux / macOS — replace /dev/sdX with your SD card device
sudo dd if=dizyfi-pi-latest.img of=/dev/sdX bs=4M status=progress conv=fsync
sudo sync

Or use Raspberry Pi Imager: select “Use custom image” and pick the downloaded file.

3

First boot wizard

Insert the SD card, connect ethernet, and power on. Connect a display and keyboard for first boot (or SSH in at dizyfi.local with user pi / password dizyfi).

The first-boot wizard will guide you through:

  • Setting your artist name and bio
  • Choosing your genres
  • Uploading your music (via browser or USB stick)
  • Configuring your tunnel (free subdomain on dizyfi.uk)
4

You're live!

Once setup is complete your node registers itself with the DizyFi registry. Listeners nearby can discover your profile on dizyfi.uk/discover immediately.

Your node will automatically keep its profile in sync with the registry. If you update your bio or upload new tracks, changes propagate within minutes.

Getting paid

Coming soon

DizyFi's payment system is in beta. Artists who register early will be first in line when payouts launch. We pay 90% of revenue directly to artists weekly via Stripe.

Leave your email to be notified when payouts go live:

FAQ

Do I need a fast internet connection?

A standard home broadband connection (10 Mbps+ upload) is fine for most use cases. DizyFi streams audio at around 128–320 kbps, so even modest upload speeds support dozens of concurrent listeners.

What happens if my Pi is turned off?

Your profile remains in the registry but listeners will see your node as offline. Your music catalogue is safe on the SD card — it will be back online when you restart.

Can I use a different device, not a Pi?

The DizyFi node software runs on any Linux ARM or x86 system. The Pi image is provided for convenience but you can install manually on any machine.

How does getting paid work?

DizyFi aggregates play-second data weekly. Artists with a connected Stripe account receive 90% of revenue calculated at £0.0005 per second played. Minimum payout is 50p.

Is my music safe?

Yes. Your music files only exist on your hardware. DizyFi never uploads or copies your audio. The registry only stores your profile metadata (name, city, genres, endpoint URL).