shaarli

xsrv.shaarli

This role will install Shaarli, a minimalist bookmark manager and link sharing service.

• Demo
• Documentation
• Github project

Requirements/dependencies/example playbook

See meta/main.yml

# playbook.yml
- hosts: my.CHANGEME.org
  roles:
    - nodiscc.xsrv.common # fail2ban bruteforce protection
    - nodiscc.xsrv.backup # (optional) automatic backups
    - nodiscc.xsrv.monitoring # (optional) apache monitoring
    - nodiscc.xsrv.apache # webserver, PHP interpreter and SSL certificates
    - nodiscc.xsrv.shaarli

# host_vars/my.CHANGEME.org/my.CHANGEME.org.yml
shaarli_fqdn: "links.CHANGEME.org"

# ansible-vault edit host_vars/my.example.org/my.example.org.vault.yml
shaarli_user: "CHANGEME"
shaarli_password: "CHANGEME"
shaarli_password_salt: "CHANGEME"
shaarli_api_secret: "CHANGEME"

See defaults/main.yml for all configuration variables

Usage

Clients

Shaarli RSS can be accessed through:

• a web browser
• Browser addons or mobile applications

Backups

See the included rsnapshot configuration for the backup role.

To restore backups, deploy the role and restore the data/ directory:

sudo rsync -avP /var/backups/rsnapshot/daily.0/localhost/var/www/links.CHANGEME.org/data /var/www/links.CHANGEME.org/

Upgrades

Re-apply the role on a regular basis to ensure the application stays up to date.

This role is not always idempotent - tt-rss is always upgraded to the latest available version (git master branch).

License

GNU GPLv3

References

• https://shaarli.readthedocs.io/en/master/