Shaarli

#lang-php #web 

Shaarli is a minimalist link sharing service. It can be used to share, comment and save interesting links. It is designed to be personal (single-user), fast and handy.

Note

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

License

Shaarli is Free Software. See COPYING for a detail of the contributors and licenses for each individual component.

Prerequisites

We’re using PHP in the stable version 8.1:

[isabell@stardust ~]$ uberspace tools version show php
Using 'PHP' version: '8.1'
[isabell@stardust ~]$

Set up your domain:

[isabell@stardust ~]$ uberspace web domain list
isabell.uber.space
[isabell@stardust ~]$

Installation

Enter your document root, download the latest release and unpack the downloaded archive:

[isabell@stardust ~]$ cd ~/html
[isabell@stardust html]$ wget https://github.com/shaarli/Shaarli/releases/download/v0.12.1/shaarli-v0.12.1-full.tar.gz
[isabell@stardust html]$ tar xvzf shaarli-v0.12.1-full.tar.gz --strip-components=1
[isabell@stardust html]$

Finishing installation

Once all files have been placed at the correct location, go to https://isabell.uber.space. Enter a username and a secure password, choose your preferred language and timezone, then click on “Install”.

Updates

Note

ALL data from Shaarli will be lost when updating, please make sure to backup before upgrading.

Shaarli stores user data and configuration under the data directory. Remember to backup this folder before upgrading Shaarli:

[isabell@stardust ~]$ cp -r /var/www/virtual/isabell/html/data ~/shaarli-data-backup
[isabell@stardust ~]$

Note

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

Check Shaarli’s releases for the latest version. If a newer version is available, enter your document root, download the archive, unpack it and make sure to restore your backup:

[isabell@stardust ~]$ cd ~/html
[isabell@stardust html]$ wget https://github.com/shaarli/Shaarli/releases/download/v0.X.Y/shaarli-v0.X.Y-full.tar.gz
[isabell@stardust html]$ tar xvzf shaarli-v0.X.Y-full.tar.gz --strip-components=1
[isabell@stardust html]$ cp -r ~/shaarli-data-backup/* /var/www/virtual/isabell/html/data/
[isabell@stardust html]$

Tested with Shaarli 0.12.1, PHP 8.1 and Uberspace 7.13.0

Written by: Kevin Jost <https://github.com/systemsemaphore>