This distribution is verified by the Obsidian team but isn't supported.
First add Flathub repository. Then run:
$ flatpak install md.obsidian.Obsidian
Obsidian has a fairly complete Wayland backend which brings about several improvements over X11, including:
Wayland support can be enabled by setting the environment variable --socket=wayland
either using Flatseal, or the command line, like so:
$ flatpak override --user --socket=wayland md.obsidian.Obsidian
Wayland support can also be temporarily enabled for a single run:
$ flatpak run --socket=wayland md.obsidian.Obsidian
There are some features that don't yet work in Obsidian when running as a native Wayland client:
Input method frameworks
There don't appear to ways to work around these issues, and until they're resolved the Obsidian flatpak will use XWayland by default.
GPU acceleration may need to be disabled to avoid launching with graphical bugs:
$ flatpak override --user --env=OBSIDIAN_DISABLE_GPU=1 md.obsidian.Obsidian
The pandoc plugin partially works with the bundled pandoc
binary; however, it requires an extension to utilize pdflatex
:
$ flatpak install flathub org.freedesktop.Sdk.Extension.texlive//22.08
This flatpak bundles the gh
binary (the github cli), so use that to login from your distro's command line:
$ flatpak run --command=gh md.obsidian.Obsidian auth login
A git repo can also be set up by running the following:
$ flatpak run --command=gh md.obsidian.Obsidian auth setup-git
The gh
binary can resolve to /app/bin/gh
in ~/.gitconfig
after running gh auth setup-git
in flatpak, which may be problematic if gh
is needed outside of flatpak. This can be worked around like so:
$ sed -i 's@/app/bin/@@g' ~/.gitconfig
Middle-click auto-scrolling can be enabled with the following:
$ flatpak override --user --env=OBSIDIAN_ENABLE_AUTOSCROLL=1 md.obsidian.Obsidian
This flatpak goes into great lengths to provide a nice experience for end users. In order for the Git plugin to work it requires permission to the ssh-auth socket (--socket=ssh-auth
). It also exposes the home directory in the sandbox (required for Drag and Drop operations). If you don't use the Git plugin you can disable the ssh-auth socket permission, e.g. using Flatseal. You can also remove access to the home directory if you want and the flatpak will continue to work, albeit with reduced functionality. In case you do remove access to the homedir, note that in order for things to not break for the Git plugin, --persist=.ssh
flag has been passed and a bind mount to ~/.var/app/md.obsidian.Obsidian/
is created by flatpak, allowing that location to be used for persistent data (but your home directory's .ssh remains unaccessible)
Obsidian can use XDG desktop portals to open vaults. If plugins aren't needed, then widespread host filesystem access can be revoked:
$ flatpak override --user \
--nofilesystem=home \
--nofilesystem=/run/media \
--nofilesystem=/mnt \
--nofilesystem=/media \
--nofilesystem=xdg-run/app/com.discordapp.Discord \
md.obsidian.Obsidian
The Obsidian flatpak doesn't need OTA updates to stay up-to-date. If plugins aren't being used or are already installed, then network access can be disabled:
$ flatpak override --user --unshare=network md.obsidian.Obsidian
SSH support is commonly used with the Git plugin. If SSH support isn't needed, then it can be disabled:
$ flatpak override --user --nosocket=ssh-auth md.obsidian.Obsidian
Sometimes Pulseaudio access is needed, although it can be disabled under most circumstances:
$ flatpak override --user --nosocket=pulseaudio md.obsidian.Obsidian
IPC namespace sharing is required for using the X11 shared memory extension so applications can perform well under X11, however it can be disabled without a performance penalty by using Obsidian's Wayland backend:
$ flatpak \
override \
--user \
--socket=wayland \
--unshare=ipc \
--nosocket=x11 \
md.obsidian.Obsidian