Getting Started with the FunHoard Server

Installation

  1. Go to the Download page and download FunHoard for Mac
  2. Open the DMG and drag FunHoard to your Applications folder
  3. Launch FunHoard from Applications

The app appears as a menu bar icon (🖥️) in the top-right of your screen. Everything — the database, media scanner, web interface — starts automatically.

Option 2: Run from Source

If you prefer to run from source (for development or customisation):

git clone https://github.com/storizzi/media-server.git
cd media-server
./install.sh

The install script sets up Python, Node.js, MongoDB, and FFmpeg via Homebrew, then starts all services.

First Run

When FunHoard starts for the first time:

  1. Open the web interface — visit http://localhost:3742 in your browser, or click “Open in Browser” from the menu bar icon
  2. Log in with the default credentials:
    • Username: admin
    • Password: admin
  3. Change your password immediately — go to Settings → Account → Change Password

⚠️ The default password is admin — change it before setting up remote access.

The Web Interface

The web interface lets you:

  • Browse your media library with search, filters, and folder navigation
  • Play audio, video, and documents directly in the browser
  • Create playlists and manage your media queue
  • Configure directories, users, and server settings

The FunHoard menu bar icon shows the status of all services:

  • 🟢 All services running
  • 🟡 Some services running
  • 🔴 No services running

Click the icon to:

  • Open in Browser — launch the web interface
  • Start/Stop/Restart all services
  • Show Logs — open the log directory in Finder
  • Quit — stop all services and exit

What’s Next?