Help → Navidrome → Upload your first album

Upload your first album

Add music to your library from the Terrarium dashboard. Upload individual files or zip archives — beets automatically tags, organizes, and enriches them.

Your music library is empty right now — let's get some music in there.

How to upload

  1. Go to your Terrarium dashboard and click the Files tab
  2. Under My Music, drag files onto the drop zone — or click it to browse. You can upload individual audio files or zip archives
  3. Wait for the upload and processing to finish — this usually takes a few minutes per album

What beets does

When the checkbox is on, your files go through beets, which:

  • Identifies tracks using audio fingerprinting (via MusicBrainz)
  • Corrects artist, album, and track names
  • Downloads and embeds cover art into your audio files
  • Assigns genres automatically
  • Downloads lyrics
  • Organizes files into Artist/Album/ folders inside your library

When it's done, your files appear in the tree under library/. Navidrome picks them up automatically — open your music app and they'll be there.

Skipping beets

If your files are already well-tagged (e.g., from a CD ripper or another music manager), uncheck Analyze with beets. Files go directly into library/ without processing, preserving your existing tags and folder structure.

Supported formats

Navidrome plays MP3, FLAC, AAC (M4A), OGG Vorbis, Opus, WMA, and WAV. Upload whatever you have — no conversion needed.

Storage

Music files add up. A typical album is 80–150 MB for MP3, or 300–500 MB for FLAC. You can see how much storage you're using on the Files tab.