MirrorMirror
/
funkwhale
mirror of https://dev.funkwhale.audio/funkwhale/funkwhale.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Add Nginx update instructions to Debian guide 

Part-of: <https://dev.funkwhale.audio/funkwhale/funkwhale/-/merge_requests/2415>
This commit is contained in:
Sporiff 2023-04-27 13:24:22 +02:00
parent 3028672096
commit 7853330790
2 changed files with 41 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
changes/changelog.d/2050.doc Normal file
View File

@ -0,0 +1 @@
Added Nginx regeneration instructions to Debian update guide (#2050)

41
docs/administrator/upgrade/debian.md
View File

@ -31,9 +31,48 @@ If you installed Funkwhale following the [Debian guide](../installation/debian.m
``` ```
2. Follow the [Download Funkwhale](../installation/debian.md#3-download-funkwhale) instructions in the installation guide. 2. Follow the [Download Funkwhale](../installation/debian.md#3-download-funkwhale) instructions in the installation guide.
3. Follow the [Install the Funkwhale API](../installation/debian.md#4-install-the-funkwhale-api) instructions in the installation guide. 3. Follow the [Install the Funkwhale API](../installation/debian.md#4-install-the-funkwhale-api) instructions in the installation guide.
## Update your reverse proxy configuration
To ensure your reverse proxy is up-to-date with changes, you should regenerate your Nginx configuration with each upgrade. To do this:
1. Log in to a root shell to make changes to the config files
```console
$ sudo su
```
2. Download the new Nginx templates from Funkwhale
```console
# curl -L -o /etc/nginx/funkwhale_proxy.conf "https://dev.funkwhale.audio/funkwhale/funkwhale/raw/$FUNKWHALE_VERSION/deploy/funkwhale_proxy.conf"
# curl -L -o /etc/nginx/sites-available/funkwhale.template "https://dev.funkwhale.audio/funkwhale/funkwhale/raw/$FUNKWHALE_VERSION/deploy/nginx.template"
```
3. Update the Nginx configuration with details from your {file}`.env` file
```console
# set -a && source /srv/funkwhale/config/.env && set +a
envsubst "`env | awk -F = '{printf \" $%s\", $$1}'`" \
< /etc/nginx/sites-available/funkwhale.template \
> /etc/nginx/sites-available/funkwhale.conf
```
4. Check the configuration file to make sure the template values have been updated properly
```console
# grep '${' /etc/nginx/sites-enabled/funkwhale.conf
```
5. Restart Nginx
```console
# systemctl restart nginx
```
## Update your Funkwhale instance ## Update your Funkwhale instance
Once you have downloaded the new files, you can update your Funkwhale instance. To do this: Once you have downloaded the new files, you can update your Funkwhale instance. To do this: