How to Install Funkwhale on macOS

In this tutorial, we will guide you through the process of installing Funkwhale on your macOS device.

Prerequisites

Steps

  1. Open the Terminal app on your macOS device.

  2. Install Homebrew by running the following command:

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    
  3. Once Homebrew is installed, update the package index by running the following command:

    brew update
    
  4. Install Docker by running the following command:

    brew install docker
    
  5. Next, we need to create a directory to store the Funkwhale data. You can choose any directory you prefer. For this example, we will use the directory /funkwhale-data. Run the following command to create the directory:

    sudo mkdir -p /funkwhale-data
    
  6. Change the ownership of the directory to the current user by running the following command:

    sudo chown -R $USER:$USER /funkwhale-data
    
  7. Now, we can download the Funkwhale docker-compose file by running the following command:

    curl https://dev.funkwhale.audio/funkwhale/docker-compose.yml -o docker-compose.yml
    
  8. Open the docker-compose.yml file in a text editor and modify the following lines:

    - /srv/funkwhale-data/db:/var/lib/postgresql/data
    - /srv/funkwhale-data/nginx:/etc/nginx/conf.d
    - /srv/funkwhale-data/media:/srv/funkwhale/media
    

    Replace /srv/funkwhale-data with the directory you created in step 5.

  9. We can now start the Funkwhale server by running the following command in the terminal:

    docker-compose up -d
    

    This command will download the required images and spin up containers for the Funkwhale server and the PostgreSQL database.

  10. Once the containers are up and running, you can access the Funkwhale instance by visiting http://localhost:5000 in your web browser.

Congratulations! You have successfully installed Funkwhale on your macOS device. You can now start enjoying your music library on your very own music server.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!