kopia lustrzana https://dev.funkwhale.audio/funkwhale/funkwhale
82 wiersze
2.7 KiB
ReStructuredText
82 wiersze
2.7 KiB
ReStructuredText
Docker installation
|
|
====================
|
|
|
|
Docker is the easiest way to get a Funkwhale instance up and running.
|
|
|
|
First, ensure you have `Docker <https://docs.docker.com/engine/installation/>`_ and `docker-compose <https://docs.docker.com/compose/install/>`_ installed.
|
|
|
|
Download the sample docker-compose file:
|
|
|
|
.. parsed-literal::
|
|
|
|
mkdir /srv/funkwhale
|
|
cd /srv/funkwhale
|
|
mkdir nginx
|
|
curl -L -o nginx/funkwhale.template "https://dev.funkwhale.audio/funkwhale/funkwhale/raw/master/deploy/docker.nginx.template"
|
|
curl -L -o nginx/funkwhale_proxy.conf "https://dev.funkwhale.audio/funkwhale/funkwhale/raw/master/deploy/funkwhale_proxy.conf"
|
|
curl -L -o docker-compose.yml "https://dev.funkwhale.audio/funkwhale/funkwhale/raw/master/deploy/docker-compose.yml"
|
|
|
|
At this point, the archticture of ``/srv/funkwhale`` should look like that:
|
|
|
|
::
|
|
|
|
.
|
|
├── docker-compose.yml
|
|
├── .env
|
|
└── nginx
|
|
├── funkwhale_proxy.conf
|
|
└── funkwhale.template
|
|
|
|
Create your env file:
|
|
|
|
.. parsed-literal::
|
|
|
|
export FUNKWHALE_VERSION="|version|"
|
|
curl -L -o .env "https://dev.funkwhale.audio/funkwhale/funkwhale/raw/master/deploy/env.prod.sample"
|
|
sed -i "s/FUNKWHALE_VERSION=latest/FUNKWHALE_VERSION=$FUNKWHALE_VERSION/" .env
|
|
sudo nano .env
|
|
|
|
Ensure to edit it to match your needs (this file is heavily commented), in particular ``DJANGO_SECRET_KEY`` and ``FUNKWHALE_HOSTNAME``.
|
|
You should take a look at the `configuration reference <https://docs.funkwhale.audio/configuration.html#configuration-reference>`_ for more detailed information regarding each setting.
|
|
|
|
Then, you should be able to pull the required images:
|
|
|
|
.. code-block:: bash
|
|
|
|
docker-compose pull
|
|
|
|
Run the database container and the initial migrations:
|
|
|
|
.. code-block:: bash
|
|
|
|
docker-compose up -d postgres
|
|
docker-compose run --rm api python manage.py migrate
|
|
|
|
.. warning::
|
|
|
|
You may sometimes get the following warning while applying migrations::
|
|
|
|
"Your models have changes that are not yet reflected in a migration, and so won't be applied."
|
|
|
|
This is a warning, not an error, and it can be safely ignored.
|
|
Never run the ``makemigrations`` command yourself.
|
|
|
|
Create your admin user:
|
|
|
|
.. code-block:: bash
|
|
|
|
docker-compose run --rm api python manage.py createsuperuser
|
|
|
|
Then launch the whole thing:
|
|
|
|
.. code-block:: bash
|
|
|
|
docker-compose up -d
|
|
|
|
Now, you just need to configure your :ref:`reverse-proxy <reverse-proxy-setup>`. Don't worry, it's quite easy.
|
|
|
|
About music acquisition
|
|
-----------------------
|
|
|
|
If you want to :doc:`import music located on the server </importing-music>`, you can put it in the ``data/music`` directory and it will become readable by the importer.
|