kopia lustrzana https://dev.funkwhale.audio/funkwhale/funkwhale
362 wiersze
15 KiB
Plaintext
362 wiersze
15 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2022, The Funkwhale Collective
|
|
# This file is distributed under the same license as the funkwhale package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: funkwhale 1.2.3\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:1
|
|
msgid "Install Funkwhale on Debian"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:3
|
|
msgid "We support [Debian](https://debian.org) and Debian-based Linux distributions. Follow these steps to set up Funkwhale on a Debian server."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:10
|
|
msgid "Before you begin"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:12
|
|
msgid "Set a `FUNKWHALE_VERSION` variable to the version you want to install. You will use this version for all commands in this guide."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:18
|
|
msgid "Install `curl`."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:25
|
|
msgid "1. Install Funkwhale dependencies"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:27
|
|
msgid "To install Funkwhale on your server, you first need to install its dependencies. We provide all dependencies in a single file to enable you to install everything at once. You can pass the information from this file to `apt` using the following command:"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:33
|
|
msgid "When prompted, hit {kbd}`y` to confirm the install."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:35
|
|
msgid "That's it! `apt` installs all dependencies and tells you once it has finished."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:37
|
|
msgid "2. Create a Funkwhale user"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:39
|
|
msgid "It's good practice to create a user on your server for Funkwhale administration. Doing this makes it easy to make sure you're running commands from the right place. Follow these steps to set up your user."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:41
|
|
msgid "Create the `funkwhale` user and set its shell to `bash` and its home directory to `/srv/funkwhale`."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:47
|
|
msgid "Create a password for the user. You need to do this so that you can use this user to perform database administration."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:53
|
|
msgid "Finally, give the user `sudo` privileges. You need to do this so that the user can run administrative tasks."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:59
|
|
msgid "That's it! You've created your `funkwhale` user. Log in as this user when you want to perform any Funkwhale related tasks."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:61
|
|
msgid "3. Download Funkwhale"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:63
|
|
msgid "Once you've created your `funkwhale` user you can download the Funkwhale software itself."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:65
|
|
msgid "Create the directory layout"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:67
|
|
msgid "Log in to your `funkwhale` account and go to the `/srv/funkwhale` directory."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:74
|
|
msgid "Create the directories for Funkwhale."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:80
|
|
msgid "That's it! Your directory structure should look like this:"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:93
|
|
msgid "Download the Funkwhale release"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:95
|
|
msgid "Once you've created the directory structure you can download Funkwhale. Funkwhale comes in two parts: the API and the Frontend. You need both to run the application."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:97
|
|
msgid "Download the API."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:106
|
|
msgid "Download the frontend"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:116
|
|
msgid "You're done! These commands put the software in the correct location for Funkwhale to serve them."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:118
|
|
msgid "4. Install Python dependencies"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:120
|
|
msgid "The Funkwhale API is written in Python. You need to install the API's dependencies to run the software. We use [Poetry](https://python-poetry.org) to handle Python dependencies."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:122
|
|
msgid "Install Poetry. Follow the steps in this wizard to set it up."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:128
|
|
msgid "Add Poetry to your `$PATH`. This allows you to use `poetry` commands."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:134
|
|
msgid "Set up poetry in your `/srv/funkwhale/api` directory."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:141
|
|
msgid "You're done! Poetry installs all Python dependencies."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:143
|
|
msgid "5. Set up your environment file"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:145
|
|
msgid "The environment file contains options you can use to control your Funkwhale pod. Follow these steps to get a working environment up and running."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:147
|
|
msgid "Download the `.env` template to your `/srv/funkwhale/config` directory."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:153
|
|
msgid "Generate a secret key for Django. This keeps your Funkwhale data secure. Do not share this key with anybody."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:159
|
|
msgid "Reduce the permissions on your `.env` file to `600`. This means that only the `funkwhale` user can read and write this file."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:165
|
|
msgid "Open the `.env` file in a text editor. For this example, we will use `nano`."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:171
|
|
msgid "Update the following settings:"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:172
|
|
msgid "Paste the secret key in the `DJANGO_SECRET_KEY` field."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:173
|
|
msgid "Populate the `DATABASE_URL` field:"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:179
|
|
msgid "Populate the `CACHE_URL` field:"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:185
|
|
msgid "Populate the `FUNKWHALE_HOSTNAME` field with the URL of your server."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:187
|
|
msgid "Hit {kbd}`ctrl + x` then {kbd}`y` to save the file and close `nano`."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:189
|
|
msgid "You're done! Your environment file is now ready to go. You can check out a full list of configuration options in our Environment file guide."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:191
|
|
msgid "6. Set up your database"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:193
|
|
msgid "Funkwhale uses a [PostgreSQL](https://www.postgresql.org/) database to store information. Follow these steps to set up your database."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:195
|
|
msgid "Install PostgreSQL and the `postgresql-contrib` package. This package contains extra features that Funkwhale uses."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:201
|
|
msgid "Once you've installed PostgreSQL, launch a `psql` shell as the `postgres` user to set up your database."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:207
|
|
msgid "Create your Funkwhale database."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:213
|
|
msgid "Create a user for Funkwhale. This user needs all privileges so it can manage the database."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:220
|
|
msgid "Once you're finished, exit the shell"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:226
|
|
msgid "Run the following commands to create extra extensions for the `funkwhale` database."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:233
|
|
msgid "Your database is ready to be populated! Use the `manage.py` script to create the database structure."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:241
|
|
msgid "You may see the following warning when applying migrations:"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:247
|
|
msgid "You can safely ignore this warning."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:250
|
|
msgid "That's it! You've finished setting up your database."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:252
|
|
msgid "7. Set up Funkwhale"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:254
|
|
msgid "Once you have got your database up and running, you can get Funkwhale ready to launch. Use the built-in `manage.py` script to get things ready."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:256
|
|
msgid "Create a superuser for your pod"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:259
|
|
msgid "You can create several superusers."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:262
|
|
msgid "To start using Funkwhale, you need to create a superuser for your pod. This user has all the permissions needed to administrate the pod. Follow these steps to create a superuser."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:268
|
|
msgid "That's it! You can log in as this user when you finish setting up Funkwhale."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:270
|
|
msgid "Collect static files"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:272
|
|
msgid "Funkwhale uses several static assets to serve its frontend. Use `manage.py` to collect these files so that the webserver can serve them."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:278
|
|
msgid "8. Set up systemd unit files"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:280
|
|
msgid "Funkwhale uses [systemd](https://www.freedesktop.org/wiki/Software/systemd/) to manage its services. systemd helps prevent downtime by bringing services back up if they fail. It also starts your Funkwhale services after a reboot. Follow these steps to set up Funkwhale services with systemd."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:282
|
|
msgid "Download the sample unit files from Funkwhale."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:291
|
|
msgid "Reload systemd to register the new services."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:297
|
|
msgid "Start all Funkwhale services."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:303
|
|
msgid "Enable the services. Systemd can then start the services after a reboot."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:311
|
|
msgid "That's it! systemd keeps these services running and starts them up in the correct order after a reboot."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:313
|
|
msgid "9. Set up a reverse proxy"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:315
|
|
msgid "Funkwhale uses a reverse proxy to serve content to users. We use [Nginx](https://nginx.com) to serve this proxy. Follow this guide to install an Nginx configuration using details from your `.env` file."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:317
|
|
msgid "Install Nginx."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:324
|
|
msgid "Download the Nginx templates from Funkwhale."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:332
|
|
msgid "Create an Nginx template with details from your `.env` file."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:355
|
|
msgid "That's it! You've created your Nginx file. Run the following command to check the `.env` details populated correctly."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:361
|
|
msgid "10. Set up TLS"
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:363
|
|
msgid "To enable your users to connect to your pod securely, you need to set up {abbr}`TLS (Transport Layer Security)`. To do this, we recommend using the <acme.sh> script."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:365
|
|
msgid "Log in as the superuser account to run these commands."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:371
|
|
msgid "Create the `/etc/certs` folder to store the certificates."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:377
|
|
msgid "Download and run `acme.sh`. Replace `my@example.com` with your email address."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:383
|
|
msgid "Generate a certificate. Replace `example.com` with your Funkwhale pod name. Use `/srv/funkwhale/front` as your web root folder."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:389
|
|
msgid "Install the certificate to your Nginx config. Replace `example.com` with your Funkwhale pod name."
|
|
msgstr ""
|
|
|
|
#: ../../administrator_documentation/installation_docs/debian.md:398
|
|
msgid "That's it! acme.sh renews your certificate every 60 days, so you don't need to about renewing it."
|
|
msgstr ""
|