Skip to content
Snippets Groups Projects
Select Git revision
  • develop default protected
  • master
  • 1121-download
  • plugins-v3
  • 876-http-signature
  • plugins-v2
  • plugins
  • 0.21.2
  • 0.21.1
  • 0.21
  • 0.21-rc2
  • 0.21-rc1
  • 0.20.1
  • 0.20.0
  • 0.20.0-rc1
  • 0.19.1
  • 0.19.0
  • 0.19.0-rc2
  • 0.19.0-rc1
  • 0.18.3
  • 0.18.2
  • 0.18.1
  • 0.18
  • 0.17
  • 0.16.3
  • 0.16.2
  • 0.16.1
27 results

external_dependencies.rst

Blame
  • Forked from funkwhale / funkwhale
    7636 commits behind the upstream repository.
    external_dependencies.rst 1.84 KiB

    External dependencies

    Note

    Those dependencies are handled automatically if you are :doc:`deploying using docker <./docker>`

    Database setup (PostgreSQL)

    Funkwhale requires a PostgreSQL database to work properly. Please refer to the PostgreSQL documentation for installation instructions specific to your os.

    On debian-like systems, you would install the database server like this:

    sudo apt-get install postgresql

    The remaining steps are heavily inspired from this Digital Ocean guide.

    Open a database shell:

    sudo -u postgres psql

    Create the project database and user:

    CREATE DATABASE funkwhale;
    CREATE USER funkwhale;
    GRANT ALL PRIVILEGES ON DATABASE funkwhale TO funkwhale;

    Assuming you already have :ref:`created your funkwhale user <create-funkwhale-user>`, you should now be able to open a postgresql shell:

    sudo -u funkwhale -H psql

    Unless you give a superuser access to the database user, you should also enable some extensions on your database server, as those are required for funkwhale to work properly:

    sudo -u postgres psql -c 'CREATE EXTENSION "unaccent";''

    Cache setup (Redis)

    Funkwhale also requires a cache server:

    • To make the whole system faster, by caching network requests or database queries
    • To handle asynchronous tasks such as music import

    On debian-like distributions, a redis package is available, and you can install it:

    sudo apt-get install redis-server

    This should be enough to have your redis server set up.