ConfigsApr 2, 2026·2 min read

Puter — Open-Source Cloud Desktop in Your Browser

Self-hostable internet OS with file system, app ecosystem, and developer APIs. Privacy-first cloud desktop. 40K+ GitHub stars.

TL;DR
Puter is a self-hostable cloud OS with file system, apps, and APIs in the browser.
§01

What it is

Puter is an open-source cloud desktop operating system that runs in your web browser. It provides a full desktop environment with a file system, app ecosystem, and developer APIs. You can self-host it on your own server or use the public instance. Puter aims to be a privacy-first alternative to cloud services like Google Drive and Dropbox by keeping your data on infrastructure you control.

It targets developers who want a web-based OS for remote access, users who want a privacy-first cloud desktop, and teams building web apps that need filesystem and storage APIs.

§02

How it saves time or tokens

Puter provides a complete cloud environment without stitching together multiple services. You get file storage, a desktop UI, and developer APIs from one Docker command. For AI workflows, you can use Puter as a sandboxed environment to test web apps, manage files remotely, or provide users with a browser-based workspace. The JavaScript SDK lets you integrate Puter's file system and auth into your own applications.

§03

How to use

  1. Start Puter with Docker:
docker run --rm -p 4100:4100 ghcr.io/heyputer/puter
  1. Open http://localhost:4100 in your browser. Your cloud desktop is ready.
  1. For development from source:
git clone https://github.com/HeyPuter/puter.git
cd puter && npm install && npm start
§04

Example

// Using Puter.js SDK in a web app
// Include <script src='https://js.puter.com/v2/'></script>

// Write a file to the cloud
await puter.fs.write('notes/ai-log.txt', 'Model output saved at ' + new Date());

// Read it back
const content = await puter.fs.read('notes/ai-log.txt');
console.log(content.toString());

// Use key-value store
await puter.kv.set('last_model', 'claude-sonnet');
const model = await puter.kv.get('last_model');
§05

Related on TokRepo

§06

Common pitfalls

  • Puter runs in the browser, so performance depends on the host server and network speed. Large file operations may be slower than native filesystem access.
  • The app ecosystem is growing but smaller than established platforms. Check if the apps you need are available before migrating workflows.
  • Self-hosting requires securing your instance with HTTPS and authentication if exposed to the internet. The default configuration is for local development.

Frequently Asked Questions

Can I self-host Puter on my own server?+

Yes. Puter is designed for self-hosting. You can run it with a single Docker command or build from source. The Docker image exposes port 4100 by default. For production, configure a reverse proxy with HTTPS and set up persistent volume mounts for data storage.

What developer APIs does Puter provide?+

Puter offers a JavaScript SDK (puter.js) with APIs for file system operations, key-value storage, user authentication, and AI integration. You include the SDK in any web page and call puter.fs, puter.kv, puter.auth, and puter.ai to access cloud services without backend code.

Is Puter free to use?+

Yes. Puter is open-source under the AGPL-3.0 license. Self-hosting is completely free. The project also offers a hosted version at puter.com with free and paid tiers, but self-hosting gives you full control at zero cost.

How does Puter compare to Google Drive or Dropbox?+

Puter provides a full desktop environment, not just file storage. You get a visual desktop with apps, a file manager, and developer APIs. The key difference is privacy: you host your own instance, so your data stays on your server. Google Drive and Dropbox are cloud-only services controlled by the provider.

Can Puter integrate with AI models?+

Yes. Puter includes a puter.ai API that provides access to language models. You can call puter.ai.chat() from the SDK to send prompts and receive responses. This lets you build AI-powered web apps that run inside the Puter desktop or embed Puter's AI features in external applications.

Citations (3)
🙏

Source & Thanks

Created by HeyPuter. Licensed under AGPL-3.0.

puter — ⭐ 40,100+

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets