selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

PhreshOS logo

Self-host PhreshOS

v0.8.6

Self-hosted web desktop for running apps and AI agents

AlphaOpen SourceMIT
Updatedlast week
LanguageTypescript
Setup difficultyModerate
Stars
302
Ports
4300 (Desktop web interface), 5300 (Development desktop web interface)
Requires
Node.js
Install with NPM
PhreshOS Desktop showing Terminal, Files, and Map with windowsPhreshOS Desktop animation showing Terminal, Files, and Settings

What is PhreshOS?

PhreshOS is an open-source, self-hosted platform that runs web applications on your own hardware. It provides a browser-based desktop environment where each application gets its own managed server process, shared authentication, inter-app communication, storage (files, key-value, SQLite), and granular permissions. The system is designed for both human users and AI agents to use the same apps simultaneously. Installation is via npm with the @phreshos/cli package, requiring Node.js 24.15+ and optionally Bun for development. The desktop runs on port 4300 by default. PhreshOS is currently experimental and not recommended for production use.

Should you self-host PhreshOS?

PhreshOS scores 42/100 on selfhost.directory (how scoring works) and ranks #13 of 20 in Application Management. It has 302 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v0.8.6, came out on 15 October 2026.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is raspiblitz (47/100, 21 stars). It scores higher overall, so compare the two before you pick. See PhreshOS vs raspiblitz side by side.

Features

  • AI agent support
  • App development SDKs
  • Appearance theming
  • Browser-based desktop environment
  • Built-in storage (files, key-value, SQLite)
  • CLI for system and app management
  • Cross-platform (macOS, Linux, Windows)
  • Customizable desktop shell
  • Experimental statusProject states it is experimental and not production-ready
  • Granular permissions system
  • Inter-app communication
  • Live demo available
  • Managed app server processes
  • Multi-view desktop (5x5 grid)
  • Single sign-on for all apps

PhreshOS README

How to install PhreshOS

Install PhreshOS with NPM

Environment variables
PHRESHOS_HOME, PHRESHOS_PORT

npm install --global @phreshos/cli phresh system install

Installs as a user service, starts it, and prints the desktop address (usually http://localhost:4300). First visit creates the owner account.

How to configure PhreshOS

  • PHRESHOS_HOMECustom home directory for PhreshOS data

    Custom home directory for PhreshOS data

  • PHRESHOS_PORTCustom port for the desktop web interface

    Custom port for the desktop web interface

PhreshOS releases & version history

More in Application Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…