2025-11-07 17:52:19 -05:00
<h3 align="center"><img width="80" alt="Puter.com, The Personal Cloud Computer: All your files, apps, and games in one place accessible from anywhere at any time." src="https://assets.puter.site/puter-logo.png"></h3>
2024-03-02 18:39:14 -08:00
2025-11-07 17:52:19 -05:00
<h3 align="center">The Internet OS! Free, Open-Source, and Self-Hostable.</h3>
2024-03-02 18:39:14 -08:00
<p align="center">
2025-11-07 17:52:19 -05:00
<a href="https://puter.com/?ref=github.com"><strong>« LIVE DEMO »</strong></a>
2024-03-02 18:39:14 -08:00
<br />
<br />
2024-10-20 20:42:34 -07:00
<a href="https://puter.com/?ref=github.com">Puter.com</a>
2024-03-02 18:39:14 -08:00
·
2026-03-22 16:29:13 -07:00
<a href="https://apps.puter.com/">App Store</a>
2025-02-24 01:28:37 -08:00
·
2025-11-07 17:52:19 -05:00
<a href="https://developer.puter.com" target="_blank">Developers</a>
2024-03-02 18:39:14 -08:00
·
2025-02-16 19:46:09 -08:00
<a href="https://github.com/heyputer/puter-cli" target="_blank">CLI</a>
·
2024-03-02 18:39:14 -08:00
<a href="https://discord.com/invite/PQcx7Teh8u">Discord</a>
·
<a href="https://reddit.com/r/puter">Reddit</a>
·
2025-02-16 19:46:09 -08:00
<a href="https://twitter.com/HeyPuter">X</a>
2024-03-02 18:39:14 -08:00
</p>
2025-11-07 17:52:19 -05:00
<h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot-3.webp"></h3>
2024-03-02 18:39:14 -08:00
<br/>
2024-03-03 20:46:43 -08:00
## Puter
2025-11-23 23:08:32 +05:30
Puter is an advanced, open-source internet operating system designed to be feature-rich, fast, and highly extensible. Puter can be used as:
2024-07-07 15:58:17 -07:00
2025-11-07 17:52:19 -05:00
- 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!
2024-03-03 20:46:43 -08:00
2024-03-03 22:15:23 -08:00
<br/>
2025-11-07 17:52:19 -05:00
## Getting Started
2024-03-02 18:39:14 -08:00
2026-02-03 21:35:49 +00:00
2025-11-07 17:52:19 -05:00
### 💻 Local Development
2024-03-07 00:00:42 -08:00
2024-03-02 18:39:14 -08:00
``` bash
2024-03-03 22:18:22 -08:00
git clone https://github.com/HeyPuter/puter
cd puter
2024-03-02 18:39:14 -08:00
npm install
npm start
```
2025-11-07 17:52:19 -05:00
* * →** This should launch Puter at
<font color="red"> http://puter.localhost:4100 (or the next available port). </font>
2025-03-13 21:39:15 +05:30
2025-11-07 17:52:19 -05:00
If this does not work, see [First Run Issues ](./doc/self-hosters/first-run-issues.md ) for
troubleshooting steps.
2024-10-04 16:02:05 -04:00
2024-03-02 18:39:14 -08:00
<br/>
2024-07-07 15:15:19 -07:00
### 🐳 Docker
2024-03-07 00:00:42 -08:00
``` bash
2024-04-02 07:45:14 +02:00
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
2024-03-31 11:30:12 +02:00
```
2025-11-07 17:52:19 -05:00
* * →** This should launch Puter at
<font color="red"> http://puter.localhost:4100 (or the next available port). </font>
2024-03-31 11:30:12 +02:00
2024-07-07 15:03:09 -07:00
<br/>
2024-07-07 15:15:19 -07:00
### 🐙 Docker Compose
2024-03-31 11:30:12 +02:00
2024-07-16 16:32:42 -07:00
#### Linux/macOS
2024-09-01 06:18:06 -08:00
2024-03-31 11:30:12 +02:00
``` bash
2024-04-02 07:45:14 +02:00
mkdir -p puter/config puter/data
2024-04-02 07:34:55 +02:00
sudo chown -R 1000:1000 puter
2024-03-31 11:30:12 +02:00
wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
2024-03-07 18:50:30 +02:00
docker compose up
2024-03-07 00:00:42 -08:00
```
2025-11-07 17:52:19 -05:00
* * →** This should be available at
<font color="red"> http://puter.localhost:4100 (or the next available port). </font>
2024-09-01 06:18:06 -08:00
2024-07-07 15:03:09 -07:00
<br/>
2024-07-16 16:32:42 -07:00
#### Windows
2024-07-16 09:10:38 -04:00
``` powershell
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
```
2025-11-07 17:52:19 -05:00
* * →** This should launch Puter at
<font color="red"> http://puter.localhost:4100 (or the next available port). </font>
2024-09-01 06:18:06 -08:00
2024-07-16 09:10:38 -04:00
<br/>
2025-11-07 17:52:19 -05:00
### 🚀 Self-Hosting
2024-11-06 17:34:32 -08:00
2025-11-07 17:52:19 -05:00
For detailed guides on self-hosting Puter, including configuration options and best practices, see our [Self-Hosting Documentation ](https://github.com/HeyPuter/puter/blob/main/doc/self-hosters/instructions.md ).
2024-11-06 17:34:32 -08:00
<br/>
2024-07-07 15:15:19 -07:00
### ☁️ Puter.com
2025-11-07 17:52:19 -05:00
Puter is available as a hosted service at [**puter.com** ](https://puter.com ).
2024-07-07 15:15:19 -07:00
2024-07-09 19:04:09 -07:00
<br/>
2025-11-07 17:52:19 -05:00
## System Requirements
2024-08-01 17:04:45 -07:00
2025-11-07 17:52:19 -05:00
- **Operating Systems:** Linux, macOS, Windows
- **RAM:** 2GB minimum (4GB recommended)
- **Disk Space:** 1GB free space
2025-12-19 19:24:05 -08:00
- **Node.js:** Version 24+
2025-11-07 17:52:19 -05:00
- **npm:** Latest stable version
2024-08-01 17:04:45 -07:00
<br/>
2024-07-09 19:04:09 -07:00
## Support
2025-11-07 17:52:19 -05:00
Connect with the maintainers and community through these channels:
2024-07-09 19:04:09 -07:00
2025-11-07 17:52:19 -05:00
- Bug report or feature request? Please [open an issue ](https://github.com/HeyPuter/puter/issues/new/choose ).
- Discord: [discord.com/invite/PQcx7Teh8u ](https://discord.com/invite/PQcx7Teh8u )
- X (Twitter): [x.com/HeyPuter ](https://x.com/HeyPuter )
- Reddit: [reddit.com/r/puter/ ](https://www.reddit.com/r/puter/ )
- Mastodon: [mastodon.social/@puter ](https://mastodon.social/@puter )
- Security issues? [security@puter.com ](mailto:security@puter.com )
- Email maintainers at [hi@puter.com ](mailto:hi@puter.com )
2024-07-09 19:04:09 -07:00
2025-11-07 17:52:19 -05:00
We are always happy to help you with any questions you may have. Don't hesitate to ask!
2024-07-09 19:04:09 -07:00
2024-07-07 15:15:19 -07:00
<br/>
2025-11-07 17:52:19 -05:00
## License
2024-07-09 16:54:54 -07:00
2025-11-07 17:52:19 -05:00
This repository, including all its contents, sub-projects, modules, and components, is licensed under [AGPL-3.0 ](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt ) unless explicitly stated otherwise. Third-party libraries included in this repository may be subject to their own licenses.
2024-07-09 16:54:54 -07:00
<br/>
2024-08-14 07:40:37 -07:00
2025-11-07 17:52:19 -05:00
## Translations
2024-08-14 07:40:37 -07:00
2025-11-07 17:52:19 -05:00
- [Arabic / العربية ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ar.md )
- [Armenian / Հայերեն ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hy.md )
2024-08-22 08:22:18 -07:00
- [Bengali / বাংলা ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.bn.md )
2025-11-07 17:52:19 -05:00
- [Chinese / 中文 ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.zh.md )
- [Danish / Dansk ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.da.md )
- [English ](https://github.com/HeyPuter/puter/blob/main/README.md )
2024-09-14 20:15:59 +05:30
- [Farsi / فارسی ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fa.md )
2025-11-07 17:52:19 -05:00
- [Finnish / Suomi ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fi.md )
- [French / Français ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fr.md )
- [German / Deutsch ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.de.md )
- [Hebrew/ עברית ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.he.md )
2024-08-15 23:01:29 +05:30
- [Hindi / हिंदी ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hi.md )
2025-11-07 17:52:19 -05:00
- [Hungarian / Magyar ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hu.md )
- [Indonesian / Bahasa Indonesia ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.id.md )
- [Italian / Italiano ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.it.md )
- [Japanese / 日本語 ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.jp.md )
- [Korean / 한국어 ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ko.md )
- [Malay / Bahasa Malaysia ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.my.md )
2024-09-04 22:03:26 -04:00
- [Malayalam / മലയാളം ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ml.md )
2025-11-07 17:52:19 -05:00
- [Polish / Polski ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.pl.md )
- [Portuguese / Português ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.pt.md )
2025-11-24 22:34:53 +05:30
- [Punjabi / ਪੰਜਾਬੀ ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.pa.md )
2025-11-07 17:52:19 -05:00
- [Romanian / Română ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ro.md )
- [Russian / Русский ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ru.md )
- [Spanish / Español ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.es.md )
- [Swedish / Svenska ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.sv.md )
- [Tamil / தமிழ் ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ta.md )
2024-10-14 21:40:57 +05:30
- [Telugu / తెలుగు ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.te.md )
2025-11-07 17:52:19 -05:00
- [Thai / ไทย ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.th.md )
- [Turkish / Türkçe ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.tr.md )
- [Ukrainian / Українська ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ua.md )
2024-08-28 14:35:39 -07:00
- [Urdu / اردو ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ur.md )
2025-11-07 17:52:19 -05:00
- [Vietnamese / Tiếng Việt ](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.vi.md )