Install as AppImage

You can download the latest AppImage from the QOwnNotes releases page. It should be named like QOwnNotes-x86_64.AppImage on that page.

Tips

If you have jq installed, you can also download the latest AppImage directly:

# query the latest Linux release from the QOwnNotes API, parse the JSON for the URL and download it
curl -L https://api.qownnotes.org/latest_releases/linux | jq .url | xargs curl -Lo QOwnNotes-x86_64.AppImage

Then you can change the execute-permissions on the file:

chmod a+x QOwnNotes-*.AppImage

Tips

AppImages need libfuse2 to run! For example under Ubuntu you can install the library with sudo apt install libfuse2.

Afterward you should be able to execute the AppImage to run QOwnNotes.

Warning

If you want to use the automatic updater please make sure to put your AppImage in a place where your user account has write-access to, like somewhere in your home directory.

Tips

If you have troubles running the AppImage, because your glibc version is too old you can try the AppImage built on OBS, it should be built with glibc 2.16.

Portable mode

You can run the AppImage in portable mode by passing the --portable argument:

./QOwnNotes-x86_64.AppImage --portable

In portable mode all application data is stored in a Data folder next to the AppImage file instead of in your home directory. This includes:

  • Settings (Data/QOwnNotes.ini)
  • The notes database (Data/QOwnNotes.sqlite)
  • Your notes (Data/Notes/)
  • Scripts, spell-check dictionaries, and other application data

This makes it easy to carry QOwnNotes together with all your notes on a USB drive or any other portable storage device.

Tips

Make sure the directory containing the AppImage file is writable, so that the Data folder can be created next to it.