Grimmory is a self-hosted app that brings your entire book collection under one roof. Organise, read, annotate, sync, and share.
This is an unofficial snap. After installing, and waiting for the the various services to start, your instance will be accessible at http://localhost:41935
You'll probably want to connect the snap as follows to allow access your books which should be in /mnt/somewhere or /media/somewhere so that the snap can access them:
sudo snap connect grimmory:removable-media
sudo snap connect grimmory:mount-observe
There are three services, nginx (the web server), grimmory-api (the backend API server), and mariadb (the database server). The database files and logs are stored in the snap's data directory, which is preserved across snap updates.
Ports
You can change the port that each service uses with the following commands:
For the port that nginx listens on (default 41935):
sudo snap set grimmory port=<desired-port>
For the port that MariaDB listens on (default 41936):
sudo snap set grimmory database-port=<desired-port>
For the port that grimmory-api listens on (default 41937):
sudo snap set grimmory api-port=<desired-port>
After changing the ports, you will need to restart the snap for the changes to take effect:
sudo snap restart grimmory
Database
If you need to connect to the MariaDB database from outside the snap, the username is grimmory and you can use the following command to get the password:
snap get grimmory database-password
You can also connect with the following command as root:
sudo mariadb --socket=/var/snap/grimmory/common/run/mysql/mysqld.sock -u root --skip-ssl
Thank you for your report. Information you provided will help us investigate further.
There was an error while sending your report. Please try again later.
Snaps are applications packaged with all their dependencies to run on all popular Linux distributions from a single build. They update automatically and roll back gracefully.
Snaps are discoverable and installable from the Snap Store, an app store with an audience of millions.
Snap can be installed from the command line on openSUSE Leap 15.x and Tumbleweed.
You need first add the snappy repository from the terminal. Choose the appropriate command depending on your installed openSUSE flavor.
Tumbleweed:
sudo zypper addrepo --refresh https://download.opensuse.org/repositories/system:/snappy/openSUSE_Tumbleweed snappy
Leap 15.x:
sudo zypper addrepo --refresh https://download.opensuse.org/repositories/system:/snappy/openSUSE_Leap_15.6 snappy
If needed, Swap out openSUSE_Leap_15. for, openSUSE_Leap_16.0 if you’re using a different version of openSUSE.
With the repository added, import its GPG key:
sudo zypper --gpg-auto-import-keys refresh
Finally, upgrade the package cache to include the new snappy repository:
sudo zypper dup --from snappy
Snap can now be installed with the following:
sudo zypper install snapd
You then need to either reboot, logout/login or source /etc/profile to have /snap/bin added to PATH.
Additionally, enable and start both the snapd and the snapd.apparmor services with the following commands:
sudo systemctl enable --now snapd
sudo systemctl enable --now snapd.apparmor
To install Grimmory, simply use the following command:
sudo snap install grimmory --beta
Browse and find snaps from the convenience of your desktop using the snap store snap.
Interested to find out more about snaps? Want to publish your own application? Visit snapcraft.io now.