LogoLogo
  • AppFlowy
    • ⭐Start here
      • Welcome to AppFlowy Docs
      • How to get help
      • Install AppFlowy
    • 🛠️Installation
      • 🖥️System Requirements
      • 💿Installation methods
        • Mac / Windows / Linux Packages
          • Installing on Linux
            • Installing & Setting up Flutter on Linux from Source
        • Docker
    • 🌱Community
      • 🤙Get in contact
      • 📔AppFlowy Mentorship Program
        • Program Guidance
        • Proposal Template
        • Pull Request Template
        • Mentorship 2023
          • Mentee Projects
            • Calendar View for AppFlowy Database
            • Custom Themes
            • Shortcuts and Customized Hotkeys for AppFlowy
            • Table
            • ⭐Favorites
            • Code Block
            • Outlines
            • Importers
            • AI Writers
            • Templates
          • Project Ideas
      • ✍️Write for AppFlowy
        • 📃Drafts
          • [Draft] Use Case: Software Engineer
          • [Draft] Use Case: High School Students
          • [Draft] How to add a new property to appflowy database
      • 🍂Hacktoberfest
    • 🛣️Roadmap
    • 🌋Product
      • 💽Data Storage
      • 🎨Customize and Style Content
      • ⏮️Duplicate, Delete, and Restore
      • 💎Databases
        • 🔢Database Properties
        • 🗃️Manage Properties
      • Ⓜ️Markdown
      • ⌨️Shortcuts
      • 🪄AppFlowy AI
      • 🦙AppFlowy Local AI - Ollama
      • 🎨Themes
      • ☁️AppFlowy Cloud
      • 🧩AppFlowy Plugins
        • Table-view Databases
        • Kanban Board
        • Calendar
        • Auto Generator
        • Smart Edit
        • Code Blocks
        • Math Equations
        • Cover
        • Emoji
  • Documentation
    • 💎Software Contributions
      • 🟢Get started
      • 💀Architecture
        • Frontend
          • Tauri
            • 🗺️CodeMap
          • Web
            • 🌟Design Philosophy
          • Flutter
            • 🗺️Project Structure: CodeMap
            • 🧮Grid
            • ⚙️Setting
          • Inter-Process Communication
          • User
            • User Data
            • Events & Notifications
          • Folder
            • Events & Notifications
          • Document
          • Database View
            • Events & Notifications
            • Grid
            • Calendar
            • Kanban Board
        • Backend
          • Initialize
          • Events
          • Delta(WIP)
          • Profiling
          • Database
        • Domain Driven Design
        • Proposals
      • 🏗️Conventions
        • 🔤Naming Conventions
        • ⌨️Code Conventions
          • 🐦Flutter
        • 🐙Git Conventions
      • 💛Submitting Code
        • 🏦Setting Up Your Repositories
        • ⤴️Submitting your first Pull Request
      • 🤟Coding Standards and Practices
        • 👽Rust Backend
    • 🚀AppFlowy
      • 👾How to contribute to AppFlowy
      • 🏗️Building from Source
        • 🌳Flutter Setup
          • 🐧Building on Linux
          • 🍎Building on macOS
          • 🪟Building on Windows
        • 🌐Web Setup
        • 📡Tauri Setup
      • ☁️Debugging with AppFlowy Cloud
      • 🔁Debugging in VS Code
      • ☎️Translate AppFlowy
      • ❓Troubleshooting
      • 👮‍♀️Licenses
    • 🏍️AppFlowy Editor
      • ⌨️How to Implement Markdown Syntax To Style Text In AppFlowy Editor
      • 🧩How to Create a Plugin for AppFlowy Editor
      • 👮‍♀️Licenses
    • ☁️AppFlowy Cloud
      • 🌈Architecture
      • ☀️Deployment
  • Guides
    • Sync Desktop and Mobile
    • Self-Hosting AppFlowy
      • ☁️Self-hosting AppFlowy with AppFlowy Cloud
      • 🆓Self-hosting AppFlowy for free Using Supabase
    • Import From Notion
  • Blog Highlights
    • 🔮Demystifying AppFlowy Editor's Codebase
  • Handbook
    • Core values
Powered by GitBook
On this page
  • Steps to install AppFlowy on Linux
  • Emoji Font Installation
  • Optional steps to add AppFlowy to your system menu

Was this helpful?

Edit on GitHub
  1. AppFlowy
  2. Installation
  3. Installation methods
  4. Mac / Windows / Linux Packages

Installing on Linux

PreviousMac / Windows / Linux PackagesNextInstalling & Setting up Flutter on Linux from Source

Last updated 1 year ago

Was this helpful?

AppFlowy currently does not have a formal Linux installation process. However, the application can quickly and easily be installed by the end user.

Note: AppFlowy requires glibc >= 2.32 however this version is not yet available in some common linux distributions. For the record, glibc 2.33 is available on Debian testing and Ubuntu 21.04:

Note: The following steps have been verified on the following Linux distributions:

Any Linux distribution not listed here has not been tested, and the following steps may not work. If you are trying to install AppFlowy on a Linux distribution not listed here, let us know how it went so that we can add it to the list or fix any bugs that may occur.

Steps to install AppFlowy on Linux

  1. Download the latest archive file from the page.

  2. Extract the archive in a location of your choice (e.g. /opt/).

    note: Performing read/write operations in folders such as /opt may require root access. If a command fails due to missing permissions, try running it as the root user (this may be done by switching to the root user or using programs such as sudo and doas).

    note: The application will be extracted into a folder named AppFlowy.

tar -xzvf AppFlowy-linux-x86.tar.gz
  1. Go to the AppFlowy directory.

cd AppFlowy
  1. Run the application.

./app_flowy

Emoji Font Installation

AppFlowy will look for the Noto Color Emoji font on your system when trying to display emoji unicode characters. Please make sure that the font is configured so that emoji characters are displayed correctly.

note: Certain distributions (e.g. Fedora Linux) already have this set up by default. In that case, you can safely ignore this section.

  1. Install the the font:

    • On Arch and Manjaro Linux, install noto-fonts-emoji using pacman.

    • On Ubuntu Linux and Linux Mint, install fonts-noto-color-emoji using apt.

  2. Configure the font:

    • First, run fc-cache -v to reload the system font cache.

    • Then, create a file in /etc/fonts/local.conf with root privileges or ~/.config/fontconfig/fonts.conf with the following content:

<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
    <alias>
        <family>sans-serif</family>
        <prefer>
            <family>Sans</family>
            <family>Noto Color Emoji</family>
        </prefer>
    </alias>

    <alias>
        <family>serif</family>
        <prefer>
            <family>Serif</family>
            <family>Noto Color Emoji</family>
        </prefer>
    </alias>

    <alias>
        <family>monospace</family>
        <prefer>
            <family>Monospace</family>
            <family>Noto Color Emoji</family>
        </prefer>
    </alias>
</fontconfig>
  1. Log out and log back in, or reboot to see your changes.

Optional steps to add AppFlowy to your system menu

The current documentation may be out of sync with the development.

Adding an application to Linux's system menu requires some extra steps. In the steps below we assume that you have extracted the archive file contents into the /opt/ directory and that your present working directory is /opt/AppFlowy.

Add a Linux desktop file to your system

  • Rename the icon file.

mv flowylogo.svg app_flowy.svg
  • Copy the icon file so that the system will pick it up.

cp app_flowy.svg ~/.local/share/icons
  • Copy the temporary desktop file to a usable Linux desktop file. Notice the underscore in app_flowy.

cp appflowy.desktop.temp app_flowy.desktop
  • Edit the following lines in the appflowy.desktop file so that they point to the correct files.

Icon=[CHANGE_THIS]/AppFlowy/flowy_logo.svg
Exec=[CHANGE_THIS]/AppFlowy/app_flowy

For example, if you installed in /opt, this becomes:

Icon=app_flowy.svg
Exec=/opt/AppFlowy/app_flowy
  • Move the desktop file so that the system will pick it up.

mv app_flowy.desktop ~/.local/share/applications
🛠️
💿
Releases