Skip to main content

Linux

Install​

The easiest way to run latest Pragtical on Linux is to download and run one of the pre-built binaries from the GitHub releases page. These builds are compatible with GLIBC >= 2.35 or Ubuntu >= 22.04.

We provide two package types:

  • Pragtical AppImage - most recent Linux systems support AppImage, but you may need to install fuse.
  • tar.gz Portable Archive - extract and run from any directory.

32-bit support​

Official Pragtical releases do not provide binary packages for 32-bit systems. Distribution package availability can differ. Check your distribution's package listing or build from source.

32-bit version of Pragtical are not actively tested for bugs.

Due to a lack of testers, we've only been able to test whether the code can compile on a 32-bit system. This does not mean that Pragtical may run correctly.

Install via package managers​

Pragtical is packaged in distribution repositories and community package sources. The options below link to their package listings; Repology also compares versions across the repositories it tracks.

Distribution and community packages

These packages follow their maintainers' release schedules and can lag behind upstream releases. Check the package listing for supported distribution releases, architectures, and available versions. AUR, Copr, and third-party Void repositories are separate from those distributions' official repositories.

Arch Linux (via AUR)​

The Arch User Repository provides pragtical, pragtical-bin, and pragtical-git. These are community build recipes, not packages in Arch's official binary repositories.

To build the release package, review the build files, then clone the repository and run makepkg as a regular user:

git clone https://aur.archlinux.org/pragtical.git
cd pragtical
makepkg -si

Alternatively, install it via an AUR helper such as yay.

Fedora (via Copr)​

The community sentry/pragtical Copr lists release and nightly packages for the Fedora releases shown on its project page.

Copr appears unmaintained

The release packages lag behind upstream, and recent automated nightly builds have been failing. This repository appears unmaintained and should not be relied on for a working build of the latest Pragtical. Check its build history before using it. For current upstream builds, use the official Linux downloads instead.

If you still want to use this repository, enable it and install its release package:

sudo dnf copr enable sentry/pragtical
sudo dnf install pragtical

Use pragtical-nightly instead of pragtical if you want the development package. Copr is a third-party package source, not Fedora's default repository.

NixOS and Nix​

pragtical is available in Nixpkgs. The version depends on your selected channel or pinned Nixpkgs revision.

On NixOS, add it to your existing system package list and rebuild your configuration as usual:

environment.systemPackages = with pkgs; [
  pragtical
];

For a user-profile installation with Nix's nix-command and flakes features enabled, use nix profile add:

nix profile add nixpkgs#pragtical

Nix can also provide this package on other Linux distributions where Nix is installed.

ALT Linux (Sisyphus)​

ALT Linux includes pragtical in Sisyphus. On a system already configured to use that repository:

sudo apt-get install pragtical

Availability in stable ALT branches can differ; check the package page for your branch rather than assuming that every ALT release includes it.

T2 Linux​

T2 includes a pragtical package recipe. From a configured T2 source tree, its package installation workflow can build and install the editor and its dependencies:

sudo ./t2 install pragtical

This uses T2's source-based package system, not Pragtical's portable archive.

Void Linux (community repository)​

Jipok's Void repository provides a pragtical package for x86_64 glibc. This is an independent community repository, not an official Void package.

Review its repository and signing-key instructions before enabling it. Once you have configured that repository, install the package with:

sudo xbps-install -S pragtical

Portable packages​

The upstream tar.gz archives use a portable layout. Distribution packages can instead install into the normal system directories. The portable layout does not follow the UNIX Filesystem Hierarchy Standard (FHS):

pragtical/
  \- data/
  \- doc/
  \- pragtical

To install the portable package according to the FHS, do the following:

  1. Move data/ to /usr/share/pragtical.
  2. Move doc/ to /usr/share/doc/pragtical
  3. Move pragtical to /usr/bin/pragtical

Client-side decorations​

Certain Wayland desktops does not provide server-side decorations. By default, Pragtical (SDL under the hood) will use libdecor to draw client-side decorations.

To work around this, set config.borderless to true. Pragtical will draw a client-side decoration.

local config = require "core.config"
config.borderless = true