funkwhale/docs/locales/gettext/admin/configuration.pot

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

#: ../../admin/configuration.rst:2
msgid "Instance configuration"
msgstr ""

#: ../../admin/configuration.rst:4
msgid "General configuration is achieved using two type of settings:"
msgstr ""

#: ../../admin/configuration.rst:6
msgid ":ref:`environment variables <environment-variables>` and"
msgstr ""

#: ../../admin/configuration.rst:7
msgid ":ref:`instance settings <instance-settings>`."
msgstr ""

#: ../../admin/configuration.rst:12
msgid "Environment variables"
msgstr ""

#: ../../admin/configuration.rst:14
msgid "Those are located in your ``.env`` file, which you should have created during installation. A full list of available variables is given :ref:`below <environment-variables>`."
msgstr ""

#: ../../admin/configuration.rst:17
msgid "Options from this file are heavily commented, and usually target lower level and technical aspects of your instance, such as database credentials."
msgstr ""

#: ../../admin/configuration.rst:22
msgid "You should restart all Funkwhale processes when you change the values on environment variables::"
msgstr ""

#: ../../admin/configuration.rst:30
msgid "Some characters are unsafe to use in configuration variables that are URLs, such as the user and password in the database and SMTP sections. If those variables contain such characters, they must be urlencoded, for instance using the following command::"
msgstr ""

#: ../../admin/configuration.rst:37
msgid "See as well https://github.com/joke2k/django-environ#using-unsafe-characters-in-urls"
msgstr ""

#: ../../admin/configuration.rst:42
msgid "Instance settings"
msgstr ""

#: ../../admin/configuration.rst:44
msgid "These settings are stored in the database and do not require a restart of your instance after modification. They typically relate to higher level configuration, such your instance description, signup policy and so on."
msgstr ""

#: ../../admin/configuration.rst:48
msgid "You can edit those settings directly from the web application, assuming you have the required permissions. The URL is ``/manage/settings``, and you will also find a link to this page in the sidebar."
msgstr ""

#: ../../admin/configuration.rst:52
msgid "If you plan to use acoustid and external imports (e.g. with the YouTube backends), you should edit the corresponding settings in this interface."
msgstr ""

#: ../../admin/configuration.rst:58
msgid "If you have any issue with the web application, a management interface is also available for those settings from :doc:`Django's administration interface <django>`. It's less user friendly, though, and we recommend you use the web app interface whenever possible."
msgstr ""

#: ../../admin/configuration.rst:63
msgid "The URL should be ``/api/admin/dynamic_preferences/globalpreferencemodel/`` (prepend your domain in front of it, of course)."
msgstr ""

#: ../../admin/configuration.rst:67
msgid "Configuration reference"
msgstr ""

#: ../../admin/configuration.rst:70
msgid "Pod"
msgstr ""

#: ../../docstring of config.settings.common.FUNKWHALE_HOSTNAME:1
msgid "Hostname of your Funkwhale pod, e.g. ``mypod.audio``"
msgstr ""

#: ../../docstring of config.settings.common.FUNKWHALE_PROTOCOL:1
msgid "Protocol end users will use to access your pod, either ``http`` or ``https``."
msgstr ""

#: ../../admin/configuration.rst:77
msgid "Database and redis"
msgstr ""

#: ../../docstring of config.settings.common.DATABASE_URL:1
msgid "URL to connect to the PostgreSQL database. Examples:"
msgstr ""

#: ../../docstring of config.settings.common.DATABASE_URL:3
msgid "``postgresql://funkwhale@:5432/funkwhale``"
msgstr ""

#: ../../docstring of config.settings.common.DATABASE_URL:4
msgid "``postgresql://<user>:<password>@<host>:<port>/<database>``"
msgstr ""

#: ../../docstring of config.settings.common.DATABASE_URL:5
msgid "``postgresql://funkwhale:passw0rd@localhost:5432/funkwhale_database``"
msgstr ""

#: ../../docstring of config.settings.common.DB_CONN_MAX_AGE:1
msgid "Max time, in seconds, before database connections are closed."
msgstr ""

#: ../../docstring of config.settings.common.CACHE_URL:1
msgid "URL to your redis server. Examples:"
msgstr ""

#: ../../docstring of config.settings.common.CACHE_URL:3
msgid "``redis://<host>:<port>/<database>``"
msgstr ""

#: ../../docstring of config.settings.common.CACHE_URL:4
#: ../../docstring of config.settings.common.CELERY_BROKER_URL:7
msgid "``redis://127.0.0.1:6379/0``"
msgstr ""

#: ../../docstring of config.settings.common.CACHE_URL:5
msgid "``redis://:password@localhost:6379/0``"
msgstr ""

#: ../../docstring of config.settings.common.CACHE_URL:6
msgid "for password auth (the extra semicolon is important) - ``redis:///run/redis/redis.sock?db=0`` over unix sockets"
msgstr ""

#: ../../docstring of config.settings.common.CACHE_URL:11
msgid "If you want to use Redis over unix sockets, you'll also need to update :attr:`CELERY_BROKER_URL`"
msgstr ""

#: ../../docstring of config.settings.common.CELERY_BROKER_URL:1
msgid "URL to celery's task broker. Defaults to :attr:`CACHE_URL`, so you shouldn't have to tweak this, unless you want to use a different one, or use Redis sockets to connect."
msgstr ""

#: ../../docstring of config.settings.common.CELERY_BROKER_URL:5
msgid "Exemple:"
msgstr ""

#: ../../docstring of config.settings.common.CELERY_BROKER_URL:8
msgid "``redis+socket:///run/redis/redis.sock?virtual_host=0``"
msgstr ""

#: ../../admin/configuration.rst:88
msgid "Accounts and registration"
msgstr ""

#: ../../docstring of config.settings.common.ACCOUNT_EMAIL_VERIFICATION_ENFORCE:1
msgid "Determine wether users need to verify their e-mail address before using the service. Enabling this can be useful to reduce spam or bots accounts, however, you'll need to configure a mail server so that your users can receive the verification e-mails, using :attr:`EMAIL_CONFIG`."
msgstr ""

#: ../../docstring of config.settings.common.ACCOUNT_EMAIL_VERIFICATION_ENFORCE:5
#: ../../docstring of config.settings.common.ACCOUNT_EMAIL_VERIFICATION_ENFORCE:7
msgid "Note that regardless of the setting value, superusers created through the command line will never require verification."
msgstr ""

#: ../../docstring of config.settings.common.USERS_INVITATION_EXPIRATION_DAYS:1
msgid "Expiration delay, in days, for user invitations."
msgstr ""

#: ../../docstring of config.settings.common.DISABLE_PASSWORD_VALIDATORS:1
msgid "Wether to disable password validators (length, common words, similarity with username…) used during regitration."
msgstr ""

#: ../../docstring of config.settings.common.ACCOUNT_USERNAME_BLACKLIST:1
msgid "List of usernames that will be unavailable during registration, given as a list of strings."
msgstr ""

#: ../../docstring of config.settings.common.AUTH_LDAP_ENABLED:1
msgid "Wether to enable LDAP authentication."
msgstr ""

#: ../../docstring of config.settings.common.AUTH_LDAP_ENABLED:3
msgid "See :doc:`/installation/ldap` for more information."
msgstr ""

#: ../../admin/configuration.rst:102
msgid "Media storage and serving"
msgstr ""

#: ../../docstring of config.settings.common.MEDIA_URL:1
msgid "URL where media files are served. The default value should work fine on most configurations, but could can tweak this if you are hosting media files on a separate domain, or if you host Funkwhale on a non-standard port."
msgstr ""

#: ../../docstring of config.settings.common.MEDIA_ROOT:1
msgid "Path where media files (such as album covers or audio tracks) are stored on your system. Ensure this directory actually exists."
msgstr ""

#: ../../docstring of config.settings.common.PROXY_MEDIA:1
msgid "Wether to proxy audio files through your reverse proxy. It's recommended to keep this on, as a way to enforce access control, however, if you're using S3 storage with :attr:`AWS_QUERYSTRING_AUTH`, it's safe to disable it."
msgstr ""

#: ../../docstring of config.settings.common.EXTERNAL_MEDIA_PROXY_ENABLED:1
msgid "Wether to proxy attachment files hosted on third party pods and and servers. Keeping this to true is recommended, to reduce leaking browsing information of your users, and reduce the bandwidth used on remote pods."
msgstr ""

#: ../../docstring of config.settings.common.ATTACHMENTS_UNATTACHED_PRUNE_DELAY:1
msgid "Delay in seconds before uploaded but unattached attachements are pruned from the system."
msgstr ""

#: ../../docstring of config.settings.common.REVERSE_PROXY_TYPE:1
msgid "Depending on the reverse proxy used in front of your funkwhale instance, the API will use different kind of headers to serve audio files"
msgstr ""

#: ../../docstring of config.settings.common.REVERSE_PROXY_TYPE:4
msgid "Allowed values: ``nginx``, ``apache2``"
msgstr ""

#: ../../docstring of config.settings.common.PROTECT_FILES_PATH:1
msgid "Which path will be used to process the internal redirection to the reverse proxy **DO NOT** put a slash at the end."
msgstr ""

#: ../../docstring of config.settings.common.PROTECT_FILES_PATH:4
msgid "You shouldn't have to tweak this."
msgstr ""

#: ../../admin/configuration.rst:117
msgid "Audio acquisition"
msgstr ""

#: ../../docstring of config.settings.common.MUSIC_DIRECTORY_PATH:1
msgid "The path on your server where Funkwhale can import files using :ref:`in-place import <in-place-import>`. It must be readable by the webserver and Funkwhale api and worker processes."
msgstr ""

#: ../../docstring of config.settings.common.MUSIC_DIRECTORY_PATH:5
msgid "On docker installations, we recommend you use the default of ``/music`` for this value. For non-docker installation, you can use any absolute path. ``/srv/funkwhale/data/music`` is a safe choice if you don't know what to use."
msgstr ""

#: ../../docstring of config.settings.common.MUSIC_DIRECTORY_PATH:9
#: ../../docstring of config.settings.common.MUSIC_DIRECTORY_SERVE_PATH:16
msgid "This path should not include any trailing slash."
msgstr ""

#: ../../docstring of config.settings.common.MUSIC_DIRECTORY_PATH:13
msgid "You need to adapt your :ref:`reverse proxy configuration <reverse-proxy-setup>` to serve the directory pointed by ``MUSIC_DIRECTORY_PATH`` on ``/_protected/music`` URL."
msgstr ""

#: ../../docstring of config.settings.common.MUSIC_DIRECTORY_SERVE_PATH:1
msgid "Default: :attr:`MUSIC_DIRECTORY_PATH`"
msgstr ""

#: ../../docstring of config.settings.common.MUSIC_DIRECTORY_SERVE_PATH:3
msgid "When using Docker, the value of :attr:`MUSIC_DIRECTORY_PATH` in your containers may differ from the real path on your host. Assuming you have the following directive in your :file:`docker-compose.yml` file::"
msgstr ""

#: ../../docstring of config.settings.common.MUSIC_DIRECTORY_SERVE_PATH:11
msgid "Then, the value of :attr:`MUSIC_DIRECTORY_SERVE_PATH` should be ``/srv/funkwhale/data/music``. This must be readable by the webserver."
msgstr ""

#: ../../docstring of config.settings.common.MUSIC_DIRECTORY_SERVE_PATH:14
msgid "On non-docker setup, you don't need to configure this setting."
msgstr ""

#: ../../admin/configuration.rst:123
msgid "S3 Storage"
msgstr ""

#: ../../docstring of config.settings.common.AWS_QUERYSTRING_AUTH:1
msgid "Whether to include signatures in S3 urls, as a way to enforce access-control."
msgstr ""

#: ../../docstring of config.settings.common.AWS_QUERYSTRING_AUTH:3
msgid "Defaults to the inverse of :attr:`PROXY_MEDIA`."
msgstr ""

#: ../../docstring of config.settings.common.AWS_QUERYSTRING_EXPIRE:1
msgid "Expiration delay, in seconds, of signatures generated when :attr:`AWS_QUERYSTRING_AUTH` is enabled."
msgstr ""

#: ../../docstring of config.settings.common.AWS_ACCESS_KEY_ID:1
msgid "Access-key ID for your S3 storage."
msgstr ""

#: ../../docstring of config.settings.common.AWS_SECRET_ACCESS_KEY:1
msgid "Secret access key for your S3 storage."
msgstr ""

#: ../../docstring of config.settings.common.AWS_STORAGE_BUCKET_NAME:1
msgid "Bucket name of your S3 storage."
msgstr ""

#: ../../docstring of config.settings.common.AWS_S3_CUSTOM_DOMAIN:1
msgid "Custom domain to use for your S3 storage."
msgstr ""

#: ../../docstring of config.settings.common.AWS_S3_ENDPOINT_URL:1
msgid "If you use a S3-compatible storage such as minio, set the following variable to the full URL to the storage server. Example:"
msgstr ""

#: ../../docstring of config.settings.common.AWS_S3_ENDPOINT_URL:4
msgid "``https://minio.mydomain.com``"
msgstr ""

#: ../../docstring of config.settings.common.AWS_S3_ENDPOINT_URL:5
msgid "``https://s3.wasabisys.com``"
msgstr ""

#: ../../docstring of config.settings.common.AWS_S3_REGION_NAME:1
msgid "If you are using Amazon S3 to serve media directly, you will need to specify your region name in order to access files."
msgstr ""

#: ../../docstring of config.settings.common.AWS_S3_REGION_NAME:4
#: ../../docstring of config.settings.common.THROTTLING_RATES:5
#: ../../docstring of config.settings.common.MUSICBRAINZ_HOSTNAME:4
msgid "Example:"
msgstr ""

#: ../../docstring of config.settings.common.AWS_S3_REGION_NAME:6
msgid "``eu-west-2``"
msgstr ""

#: ../../docstring of config.settings.common.AWS_LOCATION:1
msgid "An optional bucket subdirectory were you want to store the files. This is especially useful if you plan to use share the bucket with other services."
msgstr ""

#: ../../admin/configuration.rst:136
msgid "API configuration"
msgstr ""

#: ../../docstring of config.settings.common.THROTTLING_ENABLED:1
msgid "Wether to enable throttling (also known as rate-limiting). Leaving this enabled is recommended especially on public pods, to improve the quality of service."
msgstr ""

#: ../../docstring of config.settings.common.THROTTLING_RATES:1
msgid "Throttling rates for specific endpoints and features of the app. You can tweak this if you are encountering to severe rate limiting issues or, on the contrary, if you want to reduce the consumption on some endpoints."
msgstr ""

#: ../../docstring of config.settings.common.THROTTLING_RATES:7
msgid "``signup=5/d,password-reset=2/d,anonymous-reports=5/d``"
msgstr ""

#: ../../docstring of config.settings.common.ADMIN_URL:1
msgid "Path to the Django admin area."
msgstr ""

#: ../../docstring of config.settings.common.ADMIN_URL:3
msgid "Examples:"
msgstr ""

#: ../../docstring of config.settings.common.ADMIN_URL:5
msgid "``^api/admin/``"
msgstr ""

#: ../../docstring of config.settings.common.ADMIN_URL:6
msgid "``^api/mycustompath/``"
msgstr ""

#: ../../docstring of config.settings.common.EXTERNAL_REQUESTS_VERIFY_SSL:1
msgid "Wether to enforce HTTPS certificates verification when doing outgoing HTTP requests (typically with federation). Disabling this is not recommended."
msgstr ""

#: ../../docstring of config.settings.common.EXTERNAL_REQUESTS_TIMEOUT:1
msgid "Default timeout for external requests."
msgstr ""

#: ../../admin/configuration.rst:145
msgid "Federation"
msgstr ""

#: ../../docstring of config.settings.common.FEDERATION_OBJECT_FETCH_DELAY:1
msgid "Delay, in minutes, before a remote object will be automatically refetched when accessed in the UI."
msgstr ""

#: ../../docstring of config.settings.common.FEDERATION_DUPLICATE_FETCH_DELAY:1
msgid "Delay, in seconds, between two manual fetch of the same remote object."
msgstr ""

#: ../../admin/configuration.rst:151
msgid "Metadata"
msgstr ""

#: ../../docstring of config.settings.common.TAGS_MAX_BY_OBJ:1
msgid "Maximum number of tags that can be associated with an object. Extra tags will be ignored."
msgstr ""

#: ../../docstring of config.settings.common.MUSICBRAINZ_HOSTNAME:1
msgid "Use this setting to change the MusicBrainz hostname, for instance to use a mirror. The hostname can also contain a port number."
msgstr ""

#: ../../docstring of config.settings.common.MUSICBRAINZ_HOSTNAME:6
msgid "``mymusicbrainz.mirror``"
msgstr ""

#: ../../docstring of config.settings.common.MUSICBRAINZ_HOSTNAME:7
msgid "``localhost:5000``"
msgstr ""

#: ../../docstring of config.settings.common.MUSICBRAINZ_CACHE_DURATION:1
msgid "How long to cache MusicBrainz results, in seconds."
msgstr ""

#: ../../admin/configuration.rst:158
msgid "Channels and podcasts"
msgstr ""

#: ../../docstring of config.settings.common.PODCASTS_RSS_FEED_REFRESH_DELAY:1
msgid "Delay, in seconds, between two fetch of RSS feeds."
msgstr ""

#: ../../docstring of config.settings.common.PODCASTS_RSS_FEED_REFRESH_DELAY:3
msgid "Reducing this mean you'll receive new episodes faster, but will require more resources."
msgstr ""

#: ../../docstring of config.settings.common.PODCASTS_RSS_FEED_MAX_ITEMS:1
msgid "Maximum number of RSS items to load in each podcast feed."
msgstr ""

#: ../../docstring of config.settings.common.PODCASTS_THIRD_PARTY_VISIBILITY:1
msgid "By default, only people who subscribe to a podcast RSS will have access to their episodes."
msgstr ""

#: ../../docstring of config.settings.common.PODCASTS_THIRD_PARTY_VISIBILITY:4
msgid "Switch to \"instance\" or \"everyone\" to change that."
msgstr ""

#: ../../docstring of config.settings.common.PODCASTS_THIRD_PARTY_VISIBILITY:6
msgid "Changing it only affect new podcasts."
msgstr ""

#: ../../admin/configuration.rst:165
msgid "Subsonic"
msgstr ""

#: ../../docstring of config.settings.common.SUBSONIC_DEFAULT_TRANSCODING_FORMAT:1
msgid "Default format for transcoding when using Subsonic API."
msgstr ""

#: ../../admin/configuration.rst:170
msgid "Email configuration"
msgstr ""

#: ../../docstring of config.settings.common.EMAIL_CONFIG:1
msgid "SMTP configuration for sending e-mails. Possible values:"
msgstr ""

#: ../../docstring of config.settings.common.EMAIL_CONFIG:3
msgid "``EMAIL_CONFIG=consolemail://``: output e-mails to console (the default)"
msgstr ""

#: ../../docstring of config.settings.common.EMAIL_CONFIG:4
msgid "``EMAIL_CONFIG=dummymail://``: disable e-mail sending completely"
msgstr ""

#: ../../docstring of config.settings.common.EMAIL_CONFIG:6
msgid "On a production instance, you'll usually want to use an external SMTP server:"
msgstr ""

#: ../../docstring of config.settings.common.EMAIL_CONFIG:8
msgid "``EMAIL_CONFIG=smtp://user@:password@youremail.host:25``"
msgstr ""

#: ../../docstring of config.settings.common.EMAIL_CONFIG:9
msgid "``EMAIL_CONFIG=smtp+ssl://user@:password@youremail.host:465``"
msgstr ""

#: ../../docstring of config.settings.common.EMAIL_CONFIG:10
msgid "``EMAIL_CONFIG=smtp+tls://user@:password@youremail.host:587``"
msgstr ""

#: ../../docstring of config.settings.common.EMAIL_CONFIG:14
msgid "If ``user`` or ``password`` contain special characters (eg. ``noreply@youremail.host`` as ``user``), be sure to urlencode them, using for example the command: ``python3 -c 'import urllib.parse; print(urllib.parse.quote_plus (\"noreply@youremail.host\"))'`` (returns ``noreply%40youremail.host``)"
msgstr ""

#: ../../docstring of config.settings.common.DEFAULT_FROM_EMAIL:1
msgid "Name and e-mail address used to send system e-mails."
msgstr ""

#: ../../docstring of config.settings.common.DEFAULT_FROM_EMAIL:3
msgid "Default: ``Funkwhale <noreply@yourdomain>``"
msgstr ""

#: ../../docstring of config.settings.common.DEFAULT_FROM_EMAIL:7
msgid "Both the forms ``Funkwhale <noreply@yourdomain>`` and ``noreply@yourdomain`` work."
msgstr ""

#: ../../docstring of config.settings.common.EMAIL_SUBJECT_PREFIX:1
msgid "Subject prefix for system e-mails."
msgstr ""

#: ../../admin/configuration.rst:179
msgid "Other settings"
msgstr ""

#: ../../docstring of config.settings.common.INSTANCE_SUPPORT_MESSAGE_DELAY:1
msgid "Delay after signup, in days, before the \"support your pod\" message is shown."
msgstr ""

#: ../../docstring of config.settings.common.FUNKWHALE_SUPPORT_MESSAGE_DELAY:1
msgid "Delay after signup, in days, before the \"support Funkwhale\" message is shown."
msgstr ""

#: ../../docstring of config.settings.common.MIN_DELAY_BETWEEN_DOWNLOADS_COUNT:1
msgid "Minimum required period, in seconds, for two downloads of the same track by the same IP or user to be recorded in statistics."
msgstr ""

#: ../../docstring of config.settings.common.MARKDOWN_EXTENSIONS:1
msgid "List of markdown extensions to enable."
msgstr ""

#: ../../docstring of config.settings.common.MARKDOWN_EXTENSIONS:3
msgid "See `<https://python-markdown.github.io/extensions/>`_."
msgstr ""

#: ../../docstring of config.settings.common.LINKIFIER_SUPPORTED_TLDS:1
msgid "Additional TLDs to support with our markdown linkifier."
msgstr ""

#: ../../admin/configuration.rst:188
msgid "User permissions"
msgstr ""

#: ../../admin/configuration.rst:190
msgid "Funkwhale's permission model works as follows:"
msgstr ""

#: ../../admin/configuration.rst:192
msgid "Anonymous users cannot do anything unless configured specifically;"
msgstr ""

#: ../../admin/configuration.rst:193
msgid "Logged-in users can use the application, but cannot do things that affect the whole instance;"
msgstr ""

#: ../../admin/configuration.rst:194
msgid "Superusers can do anything."
msgstr ""

#: ../../admin/configuration.rst:196
msgid "To make things more granular and allow some delegation of responsibility, superusers can grant specific permissions to specific users. Available permissions are:"
msgstr ""

#: ../../admin/configuration.rst:200
msgid "**Manage instance-level settings**: users with this permission can edit instance settings as described in :ref:`instance-settings`;"
msgstr ""

#: ../../admin/configuration.rst:202
msgid "**Manage library**: users with this permission can import new music in the instance;"
msgstr ""

#: ../../admin/configuration.rst:204
msgid "**Manage library federation**: users with this permission can ask to federate with other instances, and accept/deny federation requests from other instances."
msgstr ""

#: ../../admin/configuration.rst:207
msgid "There is no dedicated interface to manage users permissions, but superusers can login on the :doc:`Django's admin <django>` at ``/api/admin/`` and grant permissions to users at ``/api/admin/users/user/``."
msgstr ""

#: ../../admin/configuration.rst:212
msgid "Front-end settings"
msgstr ""

#: ../../admin/configuration.rst:214
msgid "We offer a basic mechanism to customize the behavior and look and feel of Funkwhale's Web UI. To use any of the options below, you will need to create a custom JSON configuration file and serve it on ``https://yourinstanceurl/settings.json``."
msgstr ""

#: ../../admin/configuration.rst:218
msgid "On typical deployments, this url returns a 404 error, which is simply ignored."
msgstr ""

#: ../../admin/configuration.rst:221
msgid "Set-up"
msgstr ""

#: ../../admin/configuration.rst:223
msgid "First, create the settings file:"
msgstr ""

#: ../../admin/configuration.rst:241
msgid "Once the ``settings.json`` file is created, you will need to serve it from your reverse proxy."
msgstr ""

#: ../../admin/configuration.rst:243
msgid "If you are using nginx, add the following snippet to your vhost configuration::"
msgstr ""

#: ../../admin/configuration.rst:249
msgid "On Apache, add the following to your vhost configuration::"
msgstr ""

#: ../../admin/configuration.rst:253
msgid "Then, reload your reverse proxy."
msgstr ""

#: ../../admin/configuration.rst:255
msgid "At this point, visiting ``https://yourinstanceurl/settings.json`` should serve the content of the settings.json file."
msgstr ""

#: ../../admin/configuration.rst:260
msgid "The settings.json file must be a valid JSON file. If you have any issue, try linting the file with a tool such as `<https://github.com/zaach/jsonlint>`_ to detect potential syntax issues."
msgstr ""

#: ../../admin/configuration.rst:265
msgid "Available configuration options"
msgstr ""

#: ../../admin/configuration.rst:267
msgid "Your :file:`settings.json` can contain the following options:"
msgstr ""

#: ../../admin/configuration.rst:270
msgid "Name"
msgstr ""

#: ../../admin/configuration.rst:270
msgid "Type"
msgstr ""

#: ../../admin/configuration.rst:270
msgid "Example value"
msgstr ""

#: ../../admin/configuration.rst:270
msgid "Description"
msgstr ""

#: ../../admin/configuration.rst:272
msgid "``additionalStylesheets``"
msgstr ""

#: ../../admin/configuration.rst:272
msgid "Array of URLs"
msgstr ""

#: ../../admin/configuration.rst:272
msgid "``[\"https://test/theme.css\"]`` (default: ``[]``)"
msgstr ""

#: ../../admin/configuration.rst:272
msgid "A list of stylesheets URL (absolute or relative) that the web UI should load. see the \"Theming\" section below for a detailed explanation"
msgstr ""

#: ../../admin/configuration.rst:277
msgid "``defaultServerUrl``"
msgstr ""

#: ../../admin/configuration.rst:277
msgid "URL"
msgstr ""

#: ../../admin/configuration.rst:277
msgid "``\"https://api.yourdomain.com\"`` (default: ``null``)"
msgstr ""

#: ../../admin/configuration.rst:277
msgid "The URL of the API server this front-end should connect with. If null, the UI will use the value of VUE_APP_INSTANCE_URL (specified during build) or fallback to the current domain"
msgstr ""

#: ../../admin/configuration.rst:283
msgid "Missing options or options with a ``null`` value in the ``settings.json`` file are ignored."
msgstr ""

#: ../../admin/configuration.rst:286
msgid "Theming"
msgstr ""

#: ../../admin/configuration.rst:288
msgid "To theme your Funkwhale instance, you need:"
msgstr ""

#: ../../admin/configuration.rst:290
msgid "A CSS file for your theme, that can be loaded by the front-end;"
msgstr ""

#: ../../admin/configuration.rst:291
msgid "To update the value of ``additionalStylesheets`` in your settings.json file to point to your CSS file URL."
msgstr ""

#: ../../admin/configuration.rst:308
msgid "The last step to make this work is to ensure your CSS file is served by the reverse proxy."
msgstr ""

#: ../../admin/configuration.rst:310
msgid "On nginx, add the following snippet to your vhost config::"
msgstr ""

#: ../../admin/configuration.rst:316
msgid "On Apache, use the following::"
msgstr ""

#: ../../admin/configuration.rst:326
msgid "Once done, reload your reverse proxy, refresh Funkwhale in your web browser, and you should see a red background."
msgstr ""

#: ../../admin/configuration.rst:331
msgid "You can reference external urls as well in ``additionalStylesheets``, simply use the full urls. Be especially careful with external urls as they may affect your users privacy."
msgstr ""

#: ../../admin/configuration.rst:337
msgid "Loading additional stylesheets and CSS rules can affect the performance and usability of your instance. If you encounter issues with the interfaces and use custom stylesheets, try to disable those to ensure the issue is not caused by your customizations."
msgstr ""