GStars
    HeyPuter

    HeyPuter/puter

    #769 this week

    🌐 The Internet Computer! Free, Open-Source, and Self-Hostable.

    cloud
    cloud-os
    cloud-storage
    desktop
    desktop-environment
    dropbox
    TypeScript
    AGPL-3.0
    42.8K stars
    4.0K forks
    42.8K GitHub watchers
    Updated 7/21/2026
    View on GitHub

    Backblaze Generative Media Hackathon

    Build the next generation of AI media apps with Genblaze, stored on Backblaze B2. $10,000 in prizes.

    Enter the hackathon

    Loading star history...

    Use Cases & Benefits

    • Provides a free, open-source, and self-hostable internet operating system combining cloud storage, apps, and remote desktop access in one platform.
    • Offers a privacy-first personal cloud alternative to mainstream services with a fast, extensible, and user-friendly web desktop environment.
    • Use for hosting and accessing all your files, applications, and games securely from any device with internet connectivity.
    • Use for developing, publishing, and managing websites, web apps, and games within a unified cloud-based OS framework.
    • Use for setting up a remote desktop environment to manage servers or workstations remotely with a modern web interface.

    About puter

    Puter.com, The Personal Cloud Computer: All your files, apps, and games in one place accessible from anywhere at any time.

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

    « LIVE DEMO »

    Puter.com · App Store · Developers · CLI · Discord · Reddit · X

    screenshot


    Puter

    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 should launch Puter at http://puter.localhost:4100 (or the next available port).

    If this does not work, see First Run Issues for troubleshooting steps.


    🐳 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

    → This should launch Puter at http://puter.localhost:4100 (or the next available port).


    🐙 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

    → This should be available at http://puter.localhost:4100 (or the next available port).


    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

    → This should launch Puter at http://puter.localhost:4100 (or the next available port).


    🚀 Self-Hosting

    For detailed guides on self-hosting Puter, including configuration options and best practices, see our Self-Hosting Documentation.


    ☁️ 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 23+ recommended)
    • npm: Latest stable version

    Support

    Connect with the maintainers and community through these channels:

    We are always happy to help you with any questions you may have. Don't hesitate to ask!


    License

    This repository, including all its contents, sub-projects, modules, and components, is licensed under AGPL-3.0 unless explicitly stated otherwise. Third-party libraries included in this repository may be subject to their own licenses.


    Translations

    Discover Repositories

    Search across tracked repositories by name or description