# 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.5\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-01 10:35+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 ""
