Installation

Prerequisites

Installing Melon is super easy, but it requires a few Prerequisite.

• You need .NET 8.0, which you can get Here
• You'll need a MongoDB instance to connect the server to, so spin one up either through atlas or locally before running the server.

Installation

• Once you have both of these things up and running, navigate to the GitHub Releases page for the MelonMediaServer project.
• Here, go to the latest release and download the installer.zip file.
• Once it's downloaded, either run the exe (Windows) or the dll (Linux) and it will ask for the path to the folder you want to install to. Once it's done it will close.
• Go to where you install Melon and run the MelonWebApi.(exe/dll) application. This will launch the server and launch the Console UI.
• Once the console UI is fully loaded it will take you through an Out Of Box setup experience.
  • Here you'll set up your Admin account's Username and Password, link Melon to your MongoDb instance, and link to the folders you store your music files in.
• Once you're out of the setup, you'll be left at the console menu. You can use your arrow keys + enter to navigate. You'll want to start a scan as soon as possible, as no songs will be available in your library until a scan has completed.
  • You have the choice between Full and Short scan, but for a first scan they will both end up being full scans. This is because the short scan skips files that haven't been modified since last scan.

Installation is complete! But there are a few more things to configure.

Configuration

• You may need to port forward to the PC/Server you're hosting Melon on. The port Melon uses by default is 14524, but you can change the port by setting the listening URL in the Console Settings UI.
• HTTPS allows Melon to send traffic securely, and some clients / devices may require it.
  • To setup HTTPS, follow the setup UI in the console under Network Settings -> Configure HTTPS.
  • You'll need an SSL cert, which you can get through CertBot.
  • SSL Certs expire, but Melon will inform you if your cert is expired on startup, or when you visit the HTTPS settings