Skip to content

Commit

Permalink
ext documentation nginx mod_zip (#3409)
Browse files Browse the repository at this point in the history
* Update CHANGELOG.md

* Note about missing mod_zip

As I wasted too much time in figuring out what's wrong with anonymous link downloads, I thought it would be handy to summarize my lessons learned for others

* add git

"secretly" adding git as an Ubuntu package to be installed in a fresh system. Git later referred to for obtaining the Qiita sources.

---------

Co-authored-by: Antonio Gonzalez <antgonza@gmail.com>
  • Loading branch information
sjanssen2 and antgonza committed May 16, 2024
1 parent 7c7600e commit 6ac8ee8
Showing 1 changed file with 4 additions and 1 deletion.
5 changes: 4 additions & 1 deletion INSTALL.md
Original file line number Diff line number Diff line change
Expand Up @@ -78,7 +78,7 @@ You can reboot the system with `sudo reboot` in case any packages were updated.
Next, we need to add the Postgres repository to our system:
```bash
sudo apt update
sudo apt install curl gpg gnupg2 software-properties-common apt-transport-https lsb-release ca-certificates
sudo apt install curl gpg gnupg2 software-properties-common apt-transport-https lsb-release ca-certificates git
curl -fsSL https://www.postgresql.org/media/keys/ACCC4CF8.asc|sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/postgresql.gpg
echo "deb http://apt.postgresql.org/pub/repos/apt/ `lsb_release -cs`-pgdg main" |sudo tee /etc/apt/sources.list.d/pgdg.list
```
Expand Down Expand Up @@ -238,6 +238,9 @@ If you are using [NGINX](https://www.nginx.com/) via conda, you are going to nee
mkdir -p ${CONDA_PREFIX}/var/run/nginx/
```

Note that the shipped nginx version from conda, does **not** contain the mod_zip module: https://github.com/evanmiller/mod_zip
This leads to unexpected behaviour when generating a download link for anonymous artefact sharing, i.e. Qiita returns a flat file listing artifact filepaths instead of generating a ZIP archive that contains those files. You need to compile nginx with the additional mod_zip module yourself. (I've invested multiple hours to realize that the configure routine does not properly link shared libraries to the nginx binary. Try adding `--with-ld-opt=" -Wl,-rpath,/home/foo/lib "` to the `./auto/configure` call.)

## Start Qiita

Start postgres (instructions vary depending on operating system and install method).
Expand Down

0 comments on commit 6ac8ee8

Please sign in to comment.