How to Set Up Obsidian 1.13 on Linux in 2026

If you keep more than a hundred Markdown files, you have probably already felt the pain of “where did I write that?” between a notes folder, a wiki page, a chat thread and a project document. Obsidian is a local-first Markdown note app that addresses exactly that — it stores plain .md files on your disk, lets you link them with [[wikilinks]], and visualises the whole mess as an interactive graph. As of August 2026 the project shipped Obsidian 1.13.6 / 1.13.7 / 1.13.8 with a stack of fixes that matter specifically to Linux users — the most visible being a font-selection crash that has been tripping up Arch and Fedora users for months.

This is a hands-on guide for installing and configuring Obsidian 1.13.x on a modern Linux desktop in 2026. You will install the official AppImage (or Flatpak), create a vault, enable community plugins safely, try a couple of the most useful plugins, set up Obsidian Sync if you have multiple devices, and install a theme.

1. Why Obsidian, and why now

Obsidian has three qualities that have kept it on top of the personal-KMS pile since it launched in 2020:

  • Local-first, plain Markdown. Every note is a .md file on your disk. No proprietary format, no vendor lock-in. If Obsidian dies tomorrow, your notes are still readable by vim.
  • Wikilinks [[like this]] and backlinks. Type [[Project Phoenix]] and Obsidian resolves it against any note in your vault with that name. The backlink panel shows every note that links to the current one — that is what makes a small note graph useful from day one.
  • An open plugin / theme API. Community plugins are JavaScript and CSS, installed from inside the app. The catalogue has thousands of entries at community.obsidian.md.

The reason this is a 2026 article: 1.13 (released July 30, 2026) and its 1.13.6 / 1.13.7 / 1.13.8 patch series (Aug 10 / 12 / 20, 2026) introduced a redesigned searchable Settings panel, an iOS Share Sheet, fixed an iOS editor bug, and — most relevantly for Linux — fixed “Fixed font selection page crashing on Linux” along with a storage leak when quitting, fixes for vaults sitting on network mounts, and a memory leak in Live Preview Markdown tables. If you gave up on Obsidian on Linux a year ago, it is worth another look.

2. Install Obsidian on Linux

You have three reliable installation paths on Linux. Pick the one that matches how you maintain your system.

A. Official AppImage (works on every distro)

The Obsidian team publishes a single AppImage that bundles Electron and all the required libraries. This is the most portable option and the one to use if you are on Arch, Fedora, openSUSE, Solus, or anything that does not yet package 1.13.

Bash
# Download the latest installer from the official website
cd ~/Downloads
curl -L -o Obsidian-1.13.8.AppImage 
  https://github.com/obsidianmd/obsidian-releases/releases/download/1.13.8/Obsidian-1.13.8.AppImage

chmod +x Obsidian-1.13.8.AppImage

# Optional: integrate it into your launcher
mkdir -p ~/.local/bin ~/.local/share/applications ~/.local/share/icons/hicolor/256x256/apps
mv Obsidian-1.13.8.AppImage ~/.local/bin/obsidian.AppImage
curl -L -o ~/.local/share/icons/hicolor/256x256/apps/obsidian.png 
  https://obsidian.md/images/banner.png

cat > ~/.local/share/applications/obsidian.desktop <<EOF
[Desktop Entry]
Type=Application
Name=Obsidian
Comment=Sharpen your thinking
Exec=$(realpath ~/.local/bin/obsidian.AppImage) %u
Icon=obsidian
Terminal=false
Categories=Office;TextEditor;
MimeType=text/markdown;x-scheme-handler/obsidian;
StartupWMClass=obsidian
EOF

update-desktop-database ~/.local/share/applications/

After that, search “Obsidian” in your application launcher. The MimeType line also makes Obsidian the default handler for .md files and for obsidian:// URIs (used by the community plugin browser, Obsidian Sync deep links, etc.).

B. Flatpak (best if you are on a GNOME / KDE daily-driver)

The Flathub build tracks upstream within a day or two and runs in a sandbox.

Bash
flatpak install flathub md.obsidian.Obsidian
flatpak run md.obsidian.Obsidian

The Flatpak ships its own sandboxed font configuration. If a custom font you installed system-wide does not show up inside Obsidian under Flatpak, install the matching font for your user (~/.local/share/fonts) and grant Obsidian access via Flatseal — File system → “User fonts”.

C. Native distro package (Arch, Manjaro, EndeavourOS, CachyOS, openSUSE Tumbleweed)

Bash
# Arch / Manjaro / EndeavourOS / CachyOS (AUR — the upstream is "obsidian")
yay -S obsidian            # or: paru -S obsidian

# openSUSE Tumbleweed
sudo zypper install obsidian

A note on security. The AUR package just wraps the same upstream AppImage — it does NOT include any changes to the application itself. Mirror it the same way you mirror any other binary: wget the SHA-512 sums from the GitHub release page and verify before installing.

3. Create your first vault

When you launch Obsidian for the first time on Linux:

  1. Pick Create new vault → choose a folder under ~/Documents or ~/Notes.
  2. Name it something boring like vault or kb — you will be referencing this path in a lot of shortcuts later.
  3. Leave the location as a normal folder. Do not put it under a network mount or a synced directory unless you are sure the underlying FS handles POSIX file locking properly (ext4 / btrfs / zfs yes; NFSv3 sometimes no; SMB with linux-cifs yes when cifsacl is set).
  4. Uncheck the “Create a sample vault” box if you want a clean start; check it if you want to poke around first.

Once inside, the left sidebar shows your file tree. The middle column is your note. The right column is the backlinks panel — it pops automatically once you have at least one wikilink.

A good “hello world” note:

Markdown
# Welcome

This is my knowledge vault.

I link between notes using [[wikilinks]]. For example,
[[2026-Q3-Goals]] lives somewhere else in this vault.

- [ ] Read the [Obsidian help](https://obsidian.md/help)
- [ ] Try the Calendar plugin (see below)

Now create 2026-Q3-Goals.md in the same vault, with any body text. Click the wikilink in the first note — Obsidian creates the file or jumps to the existing one, and the backlinks panel on the right lights up.

4. Enable community plugins (safely)

By default Obsidian ships with Restricted mode, which means community plugins cannot read or write outside the vault. For most use-cases (calendar, kanban, dataview, tasks) you want to flip Restricted mode off, but do it with eyes open:

  1. Open Settings → Community plugins → Turn on community plugins.
  2. Read the security warning. The most common attack vector is a malicious plugin reading your API keys. A safe rule: only install plugins with many reviews and recent updates from the in-app browser. If you have doubts, check github.com/obsidianmd/obsidian-releases/issues and the plugin author’s GitHub history before installing.
  3. Click Browse, search, install, enable — each plugin gets its own settings page.

Three plugins I’d start with on a fresh Linux vault:

Plugin Author Why I install it on day one
Calendar Liam Cain Click a date on the side calendar → opens or creates your daily note for that day.
Dataview Michael Brenan Treats frontmatter as queryable metadata. LIST FROM "projects" WHERE status = "active".
Tasks Martin Schenck Tracks #task checkboxes across the whole vault with a global query pane.

5. Try Obsidian Publish on your own vault

If you want to put a slice of your notes online as a wiki or knowledge base, Obsidian Publish is the built-in, zero-server way to do it. The official help site is itself published with Obsidian Publish — the screenshot below shows what that looks like in dark mode:

Obsidian Publish example: an Obsidian-built dark-theme help site with a three-column layout, search, sidebar navigation, and an interactive graph in the right rail.

You can publish from the desktop app:

  1. Settings → Core plugins → Enable Publish.
  2. Settings → Publish → Sign in with your Obsidian account (paid; starts at $4/month).
  3. Pick a custom subdomain yourname (becomes yourname.publish.obsidian.md).
  4. Check the files / folders you want visible, then click Publish.

Once published, the same vault surfaces end-to-end: Notes, Files, Graph, Search, Outline, and TOC all work on the published version. Password locks, custom domains and custom CSS are paid-tier add-ons — you can get quite a lot from the base tier alone.

6. Set up Obsidian Sync for multi-device

If you live on a Linux laptop, an Android phone and (occasional) an iPad, Obsidian Sync (paid) end-to-end-encrypts your vault and pushes diffs across the devices. The relevant settings surface is shown below:

Obsidian Sync: end-to-end encrypted vault sync with version history, shared vaults, and selective file-type sync (images, audio, video, PDFs).

Setup is straightforward:

  1. On Linux: Settings → Sync → Sign in with the same Obsidian account.
  2. Choose vault → Set up Sync → Pick remote vault.
  3. Select the syncing strategy:
    • Sync everything — simplest, recommended for most users under 5 GB of notes.
    • Selective sync — only sync markdown, skip images / audio / video / PDFs (saves bandwidth and keeps large media local).
  4. On the phone: install Obsidian from the Play Store / App Store, sign in, pick the same remote vault. First sync can take a while; subsequent ones are incremental.

End-to-end encryption means the Obsidian team cannot read your notes even if you ask them to recover a vault — keep your recovery key somewhere safe (1Password / Bitwarden / KeePassXC is fine).

If you would rather not pay for Sync, the standard self-hosted alternatives are Syncthing (we wrote a Syncthing guide earlier this year) for folder-level sync, or a git remote for full version history. Both work fine with Obsidian vaults; just be careful with concurrent writes.

7. Theme it

The community theme scene is one of Obsidian’s strongest assets. As of 1.13 the font selection page no longer crashes on Linux (a long-standing bug), so this is finally a one-click operation:

  1. Settings → Appearance → Themes → Manage.
  2. Pick something restrained to start with — Minimal, Things, California Coast are all sensible.
  3. (Optional) Pair the theme with Style Settings plugin if you want per-element tweaks.
  4. If you want a true monochrome feel, Primary or Minimal Theme with a custom CSS snippet hiding the titlebar is clean.

If you just want a high-contrast dark theme that matches a typical KDE Plasma or GNOME 46 dark setup, the AnuPpuccin and Ebullientworks themes are popular.

8. Tips specific to Linux in 2026

A handful of issues that show up on Linux but rarely on macOS / Windows:

  • Wayland fractional scaling (Ubuntu 24.04+, Fedora 40+, KDE Plasma 6.x): Obsidian 1.13 still ships Electron 43, which honours the system fractional scale factor. If Obsidian looks blurry, try QT_QPA_PLATFORM=wayland first — it is sometimes better than XWayland at fractional scale.
  • GPU acceleration: on Nvidia Optimus / PRIME systems, force OBSIDIAN_DISABLE_GPU=1 if you see random blanking under X11.
  • Backups: tar your vault nightly to an encrypted external drive. Even if you use Sync, the local copy is the source of truth.
  • External storage: if a vault sits on Dropbox / MEGA / pCloud, disable their LAN sync daemon on the Linux box — concurrent writes corrupt notes surprisingly often.
  • CLI launch for scripts: ~/.local/bin/obsidian.AppImage "obsidian://open?path=/home/me/Documents/vault/Daily/2026-09-04.md" opens today’s daily note from a cron / polybar / rofi script.

9. Wrap-up

Obsidian 1.13.x is the best version to install on Linux in 2026. The font selection crash is finally fixed, the settings panel is searchable, and the file-saving guard around quit means you will not lose notes to a power pull or a kernel panic as easily as on 1.11. Pair it with Calendar + Dataview + Tasks to get 80% of the value out of the box; enable Publish if you want a public knowledge base; enable Sync if you live on more than one device.

The vault itself is just a folder of .md files — you can grep it with ripgrep, back it up with tar, mirror it with rsync, version it with git. That openness is what makes Obsidian different from the SaaS note apps, and on Linux it feels right at home.

Official resource: obsidian.md/download — pick the AppImage for x86_64, the deb for Debian / Ubuntu, or the rpm openSUSE / Fedora. Changelog is at obsidian.md/changelog.

Last modified: 2026年9月4日

Author

Comments

Write a Reply or Comment

Your email address will not be published.