kopia lustrzana https://dev.funkwhale.audio/funkwhale/funkwhale
455 wiersze
15 KiB
Plaintext
455 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>, 2022.
|
|
#
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: funkwhale 1.2.5\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2022-07-01 10:35+0200\n"
|
|
"PO-Revision-Date: 2022-07-02 21:07+0000\n"
|
|
"Last-Translator: Ciarán Ainsworth <sporiff@funkwhale.audio>\n"
|
|
"Language-Team: English (United Kingdom) <https://translate.funkwhale.audio/"
|
|
"projects/documentation/administrator_documentation-installation_docs-debian/"
|
|
"en_GB/>\n"
|
|
"Language: en_GB\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=utf-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
"Plural-Forms: nplurals=2; plural=n != 1;\n"
|
|
"X-Generator: Weblate 4.13\n"
|
|
"Generated-By: Babel 2.10.1\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 "Before you begin"
|
|
|
|
#: ../../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 ""
|