All docs

Docs › Studio

Install Studio on Linux

One command for Fedora, RHEL, Rocky Linux, AlmaLinux, Ubuntu and Debian, or one line to give your AI. What it installs, what each system needs, and how to update or remove it.

One command

On the Linux computer, in a terminal:

curl -fsSL https://priorstates.com/studio/install.sh | sh

It works out which system this is, installs the two system libraries Studio needs (it asks first, and uses sudo), checks the download against the release's checksum, and installs Studio for your user only. Then start PriorStates Studio from your applications menu, or run priorstates-studio.

Studio is free. It is built for 64-bit Intel and AMD computers (x86-64).

Or let your AI do it

If an AI coding tool is already running on that computer, give it this line:

Install PriorStates Studio on this machine by following https://priorstates.com/studio/install.txt

That page is written for an AI: the steps in order, when to stop and ask you (for example when sudo wants your password), and what it must not do, such as skipping the checksum or running Studio as root.

Which systems

SystemSupportedSystem packages it needs
FedoraYeswebkit2gtk4.1 gtk3
RHEL, Rocky Linux, AlmaLinux 8 and 9Yes, with their own buildwebkit2gtk3 gtk3
Ubuntu 22.04 and later, Debian 12 and laterYes (there is also a .deb)libwebkit2gtk-4.1-0 libgtk-3-0
RHEL, Rocky Linux, AlmaLinux 10Not yetThese versions no longer ship the WebKitGTK library Studio's window uses.
ARM computersNot yet

RHEL, Rocky Linux and AlmaLinux ship an older WebKitGTK than Fedora and Ubuntu, so they have a build of their own. The installer picks it for you, and Studio's updates keep to it.

What it installs, and where

  • The program: ~/.local/share/priorstates-studio/
  • The command: ~/.local/bin/priorstates-studio
  • A menu entry: ~/.local/share/applications/priorstates-studio.desktop

Nothing else needs administrator rights: only the two system packages do. If you would rather install those yourself, run the line for your system from the table with sudo dnf install -y … (or sudo apt-get install -y …), then the installer with --no-deps.

Options, after sh -s --: --yes asks nothing (for scripts), --no-deps leaves system packages alone, --dir DIR installs somewhere else, --uninstall removes it.

curl -fsSL https://priorstates.com/studio/install.sh | sh -s -- --yes

A computer with no screen

On a server you reach over ssh, install the same way and start Studio without its window:

priorstates-studio --headless

It prints the address to open in a browser, and priorstates-studio --pair prints the link for your phone.

After installing

  • Using apps needs no AI. Making or changing apps by asking uses your own AI coding tool (Claude Code or Codex) when one is signed in on that computer, and Studio's free starter AI until then. Studio can set the tool up for you.
  • git is optional. With it, every change to your apps is kept as a version.
  • Updates: Studio tells you when a new version is out and installs it in place.
  • Removing it: curl -fsSL https://priorstates.com/studio/install.sh | sh -s -- --uninstall removes the program, its command and its menu entry. Your apps and data stay, in ~/.local/share/priorstates-studio with settings in ~/.config/priorstates-studio; delete those folders too if you want everything gone.

By hand

The downloads are on the Studio for your computer page: a .deb for Ubuntu and Debian, and an archive for everything else. Install the system packages for your system from the table, unpack the archive and run ./priorstates-studio from its folder.

If something goes wrong

  • "Studio needs two system packages": the installer could not use sudo. Run the command it printed, then the installer again.
  • "The download does not match the release's checksum": nothing was installed. Try again; if it repeats, write to service@priorstates.com.
  • priorstates-studio: command not found: ~/.local/bin is not on your PATH in this terminal. Open a new terminal, or start it as ~/.local/bin/priorstates-studio.
  • The window does not open: start it from a terminal to see why, and send us what it prints.