Running multiple shiori instances

dudeami0, 7 months ago

I’ve never ran this program, but skimmed the documentation. You should be able to use the https://github.com/go-shiori/shiori/blob/master/docs/Configuration.md#data-directory (or a custom database table following those instructions) along with the https://github.com/go-shiori/shiori/blob/master/docs/Usage.md#using-web-interface for launching the web interface. A simple bash script that should work:

<span style="font-weight:bold;color:#a71d5d;">export </span><span style="color:#323232;">SHIORI_DIR</span><span style="font-weight:bold;color:#a71d5d;">=</span><span style="color:#183691;">/path/to/shiori-data-dir
</span><span style="color:#323232;">shiori serve -p 8081
</span>

To run multiple versions, I’d suggest setting up each instance as a service on your machine in case of reboots and/or crashes.

Now for serving them, you have two options. The first is just let the users connect to the port directly, but this is generally not done for outward facing services (not that you can’t). The second is to setup a reverse proxy and route the traffic through subdomains or subpaths. Nginx is my go-to solution for this. I’ve also heard good things about Caddy. You’ll most likely have to use subdomains for this, as lots of apps assume they are the root path without some tinkering.

Edit: Corrected incorrect cli arguments and a typo.

crunchpaste, 7 months ago

Is it ok to just run a few instances with just different port numbers and environment variables? Maybe I’m overthinking it, but I thought some isolation was needed, even planned on running the instances as different users. Also, thank you for the detailed explanation.

SheeEttin, 7 months ago

github.com/go-shiori/shiori#documentation

I assume you’re running it as a web app, in which case the docs cover that. Just run multiple instances on different ports and with different storage.

Looks like they provide an official docker container, too, so running it in docker should be very easy.

crunchpaste, 7 months ago

Just with different environment variables?

SheeEttin, 7 months ago

The only one the docs mention is SHIORI_DIR, which defaults to ${XDG_DATA_HOME}/shiori, so if you’re running it under different users then it’s already going to be different.

crunchpaste, 7 months ago

Just gave it a try, and it seems to work just fine like that. Thank you.