Skip to content

Install FUTO Notes on Linux

FUTO Notes is available from the FUTO apt and rpm repositories at pkg.futoinfra.com, and as a standalone AppImage. All Linux builds are x86_64 only.

Use the apt or dnf repository if your distro supports it: the package manager installs the dependencies and updates FUTO Notes along with the rest of your system. Use the AppImage on other distros, or if you’d rather not add a repository. It updates itself from inside the app.

There is no Flatpak or Snap package.

Debian / Ubuntu (apt)

curl -fsSL https://pkg.futoinfra.com/futo-archive-key.gpg | sudo tee /usr/share/keyrings/futo-archive.gpg >/dev/null
echo 'deb [signed-by=/usr/share/keyrings/futo-archive.gpg] https://pkg.futoinfra.com/futo-notes stable main' | sudo tee /etc/apt/sources.list.d/futo-notes.list
sudo apt update && sudo apt install futo-notes

Fedora / RHEL (dnf)

sudo curl -fsSL https://pkg.futoinfra.com/futo-notes/rpm/futo-notes.repo -o /etc/yum.repos.d/futo-notes.repo
sudo dnf install futo-notes

Updating the apt and dnf packages

A .deb or .rpm install updates through apt or dnf, not from inside the app. The app never replaces files the package manager owns, so it doesn’t check for updates and there is no Updates section in its Settings. New versions arrive with your normal system updates:

# Debian / Ubuntu
sudo apt update && sudo apt upgrade
# Fedora / RHEL
sudo dnf upgrade futo-notes

AppImage

The AppImage bundles everything it needs to run, so it works on distros without an apt or dnf repository. It is built on Ubuntu 22.04, so it needs glibc 2.35 or newer.

Download FUTO-Notes-<version>-x86_64.AppImage from the download section on the homepage or the latest GitLab release. Then make it executable and run it:

chmod +x FUTO-Notes-*-x86_64.AppImage
./FUTO-Notes-*-x86_64.AppImage

The AppImage does not add itself to your application menu.

AppImage updates

The AppImage updates itself. When a new version is out, the app shows an install button in the bottom-right corner of the window. Click it and the app downloads the update, checks its signature, replaces the AppImage file, and restarts. See how FUTO Notes updates.

Because the update overwrites the AppImage where it sits, keep the file in a folder your user can write to, such as one in your home directory.

Wayland and X11

The AppImage uses native Wayland when it is available and falls back to X11. If you set GDK_BACKEND yourself, it uses your choice. To force X11, for example to work around a display problem:

GDK_BACKEND=x11 ./FUTO-Notes-*-x86_64.AppImage

Where your notes go

By default, notes are plain markdown files in a futo-notes folder inside your Documents folder, usually ~/Documents/futo-notes. See where FUTO Notes stores your notes.

Next steps