# 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 ""
