Puter: The Internet OS! Free, Open-Source, and Self-Hostable

Puter is an advanced, open-source internet operating system designed to be feature-rich, exceptionally fast, and highly extensible. Puter can be used as:

• A privacy-first personal cloud to keep all your files, apps, and games in one secure place, accessible from anywhere at any time.
• A platform for building and publishing websites, web apps, and games.
• An alternative to Dropbox, Google Drive, OneDrive, etc. with a fresh interface and powerful features.
• A remote desktop environment for servers and workstations.
• A friendly, open-source project and community to learn about web development, cloud computing, distributed systems, and much more!

Getting Started

Local Development

git clone https://github.com/HeyPuter/puter
cd puter
npm install
npm start

This will launch Puter at http://localhost:4000 (or the next available port).

Docker

mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter

Docker Compose

Linux/macOS

mkdir -p puter/config puter/data
sudo chown -R 1000:1000 puter
wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
docker compose up

Windows

mkdir -p puter
cd puter
New-Item -Path "puter\config" -ItemType Directory -Force
New-Item -Path "puter\data" -ItemType Directory -Force
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
docker compose up

Puter.com

Puter is available as a hosted service at puter.com.

System Requirements

• Operating Systems: Linux, macOS, Windows
• RAM: 2GB minimum (4GB recommended)
• Disk Space: 1GB free space
• Node.js: Version 16+ (Version 22+ recommended)
• npm: Latest stable version

https://github.com/HeyPuter/puter