Shiori is a simple bookmarks manager written in Go and distributed under the MIT License. It can be used as a command line application or via the built-in web-ui.


For this guide you should be familiar with the basic concepts of



By default, Shiori runs on port 8080.

To make the application accessible from the outside, configure a web backend:

[isabell@stardust ~]$ uberspace web backend set / --http --port <port>
Set backend for / to port <port>; please make sure something is listening!
You can always check the status of your backend using "uberspace web backend list".
[isabell@stardust ~]$


Like a lot of Go software, Shiori is distributed as a single binary. Download Shiori’s latest release and make sure that the file can be executed.

 [isabell@stardust ~]$ wget -O ~/bin/shiori
 Resolving (
 Connecting to (||:443... connected.
 HTTP request sent, awaiting response... 302 Found
 Length: 19735216 (19M) [application/octet-stream]
 Saving to: ‘/home/shiori/bin/shiori’

100%[======================================>] 19,735,216  12.2MB/s

 2020-11-11 22:04:39 (12.2 MB/s) - ‘/home/isabell/bin/shiori’ saved [19735216/19735216]
 [isabell@stardust ~]$ chmod u+x ~/bin/shiori
 [isabell@stardust ~]$


Setup daemon


To use a different port instead of 8080, you need to add -p <portnumber> to the command in your shiori.ini file. Remember to adjust the port for the web backend as well.

Create ~/etc/services.d/shiori.ini with the following content.

command=shiori serve

After creating the configuration, tell supervisord to refresh its configuration and start the service:

[isabell@stardust ~]$ supervisorctl reread
SERVICE: available
[isabell@stardust ~]$ supervisorctl update
SERVICE: added process group
[isabell@stardust ~]$ supervisorctl status
SERVICE                            RUNNING   pid 26020, uptime 0:03:14
[isabell@stardust ~]$

If it’s not in state RUNNING, check your configuration.

Finishing installation

The default user and password is shiori and gopher. Once logged in you will be able to use the web interface. To add a new account, open the settings page and click on “Add new account”. With this, the default user will be deactivated automatically.



Check the update feed regularly to stay informed about the newest version.

Check Shiori’s releases for the latest version. If a newer version is available, stop daemon by supervisorctl stop shiori and repeat the “Installation” step followed by supervisorctl start shiori to restart Shiori.

Tested with Shiori 1.5.0, Uberspace

Written by: Kevin Jost <>