2023-03-01 14:06:34 +01:00
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
2023-03-01 14:40:19 +01:00
"POT-Creation-Date: 2023-03-01 14:39+0100\n"
2023-03-01 14:06:34 +01:00
"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"
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:1
2023-03-01 14:06:34 +01:00
msgid "Develop using Docker"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:3
2023-03-01 14:06:34 +01:00
msgid "Funkwhale can be run in Docker containers for local development. You can work on any part of the Funkwhale codebase and run the container setup to test your changes. To work with Docker:"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:5
2023-03-01 14:06:34 +01:00
msgid "[Install Docker](https://docs.docker.com/install)"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:6
2023-03-01 14:06:34 +01:00
msgid "[Install docker compose](https://docs.docker.com/compose/install)"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:7
2023-03-01 14:06:34 +01:00
msgid "Clone the Funkwhale repository to your system. The `develop` branch is checked out by default"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:0
2023-03-01 14:06:34 +01:00
msgid "SSH"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:0
2023-03-01 14:06:34 +01:00
msgid "HTTPS"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:31
2023-03-01 14:06:34 +01:00
msgid "Set up your Docker environment"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:35
2023-03-01 14:06:34 +01:00
msgid "Funkwhale provides a `dev.yml` file that contains the required docker compose setup. You need to pass the `-f dev.yml` flag you run docker compose commands to ensure it uses this file. If you don't want to add this each time, you can export it as a `COMPOSE_FILE` variable:"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:43
2023-03-01 14:06:34 +01:00
msgid "To set up your Docker environment:"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:45
2023-03-01 14:06:34 +01:00
msgid "Create a `.env` file to enable customization of your setup."
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:51
2023-03-01 14:06:34 +01:00
msgid "Add the following variables to load images and enable access to Django admin pages:"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:58
2023-03-01 14:06:34 +01:00
msgid "Create a network for federation support"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:64
2023-03-01 14:06:34 +01:00
msgid "Once you've set everything up, you need to build the containers. Run this command any time there are upstream changes or dependency changes to ensure you're up-to-date."
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:70
2023-03-01 14:06:34 +01:00
msgid "Set up the database"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:72
2023-03-01 14:06:34 +01:00
msgid "Funkwhale relies on a postgresql database to store information. To set this up, you need to run the `funkwhale-manage migrate` command:"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:78
2023-03-01 14:06:34 +01:00
msgid "This command creates all the required tables. You need to run this whenever there are changes to the API schema. You can run this at any time without causing issues."
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:80
2023-03-01 14:06:34 +01:00
msgid "Set up local data"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:82
2023-03-01 14:06:34 +01:00
msgid "You need to create some local data to mimic a production environment."
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:84
2023-03-01 14:06:34 +01:00
msgid "Create a superuser so you can log in to your local app:"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:90
2023-03-01 14:06:34 +01:00
msgid "Add some fake data to populate the database. The following command creates 25 artists with random albums, tracks, and metadata."
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:98
2023-03-01 14:06:34 +01:00
msgid "Manage services"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:100
2023-03-01 14:06:34 +01:00
msgid "Once you have set up your containers, bring them up to start working on them."
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:102
2023-03-01 14:06:34 +01:00
msgid "Compile the translations:"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:108
2023-03-01 14:06:34 +01:00
msgid "Launch all services:"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:114
2023-03-01 14:06:34 +01:00
msgid "This gives you access to the following:"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:116
2023-03-01 14:06:34 +01:00
msgid "The Funkwhale webapp on `http://localhost:8000`"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:117
2023-03-01 14:06:34 +01:00
msgid "The Funkwhale API on `http://localhost:8000/api/v1`"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:118
2023-03-01 14:06:34 +01:00
msgid "The Django admin interface on `http://localhost:8000/api/admin`"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:120
2023-03-01 14:06:34 +01:00
msgid "Once you're done with the containers, you can stop them all:"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:126
2023-03-01 14:06:34 +01:00
msgid "If you want to destroy your containers, run the following:"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:132
2023-03-01 14:06:34 +01:00
msgid "Set up federation support"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:134
2023-03-01 14:06:34 +01:00
msgid "Working on federation features requires some additional setup. You need to do the following:"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:136
2023-03-01 14:06:34 +01:00
msgid "Update your DNS resolver to resolve all your .dev hostnames locally"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:137
2023-03-01 14:06:34 +01:00
msgid "Set up a reverse proxy (such as traefik) to catch .dev requests with a TLS certificate"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:138
2023-03-01 14:06:34 +01:00
msgid "Set up two or more local instances"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:140
2023-03-01 14:06:34 +01:00
msgid "To resolve hostnames locally, run the following:"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:0
2023-03-01 14:06:34 +01:00
msgid "dnsmasq"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:0
2023-03-01 14:06:34 +01:00
msgid "NetworkManager"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:164
2023-03-01 14:06:34 +01:00
msgid "To add a wildcard certificate, copy the test certificate from the `docker/ssl` folder. This certificate is a wildcard for `*.funkwhale.test`"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:171
2023-03-01 14:06:34 +01:00
msgid "To run a reverse proxy for your app:"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:173
2023-03-01 14:06:34 +01:00
msgid "Add the following configuration to your `.env` file:"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:186
2023-03-01 14:06:34 +01:00
msgid "Launch traefik using the bundled configuration:"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:192
2023-03-01 14:06:34 +01:00
msgid "Set up as many different projects as you need. Make sure the `COMPOSE_PROJECT_NAME` and `VUE_PORT` variables are unique per instance"
msgstr ""
2023-03-01 14:40:19 +01:00
#: ../../developer/setup/docker.md:202
2023-03-01 14:06:34 +01:00
msgid "You can access your project at `https://{COMPOSE_PROJECT_NAME}.funkwhale.test`."
msgstr ""