{"id":15025726,"url":"https://github.com/heyputer/puter","last_synced_at":"2025-09-09T20:40:32.883Z","repository":{"id":225909099,"uuid":"766341786","full_name":"HeyPuter/puter","owner":"HeyPuter","description":"🌐 The Internet OS! Free, Open-Source, and Self-Hostable.","archived":false,"fork":false,"pushed_at":"2025-09-05T02:38:03.000Z","size":25279,"stargazers_count":35985,"open_issues_count":191,"forks_count":2782,"subscribers_count":195,"default_branch":"main","last_synced_at":"2025-09-05T04:22:01.259Z","etag":null,"topics":["cloud","cloud-os","cloud-storage","desktop","desktop-environment","dropbox","good-first-issue","gui","javascript","nas","open-source","operating-system","os","osjs","puter","remote-desktop","storage","web-desktop","web-os","webtop"],"latest_commit_sha":null,"homepage":"https://puter.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HeyPuter.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY-ACKNOWLEDGEMENTS.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["HeyPuter"]}},"created_at":"2024-03-03T01:44:32.000Z","updated_at":"2025-09-05T03:52:00.000Z","dependencies_parsed_at":"2025-05-12T03:38:31.603Z","dependency_job_id":"a27bef03-25f5-49b9-bf14-9c9c637b79c0","html_url":"https://github.com/HeyPuter/puter","commit_stats":null,"previous_names":["heyputer/puter"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/HeyPuter/puter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HeyPuter%2Fputer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HeyPuter%2Fputer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HeyPuter%2Fputer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HeyPuter%2Fputer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HeyPuter","download_url":"https://codeload.github.com/HeyPuter/puter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HeyPuter%2Fputer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274358628,"owners_count":25270679,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-09T02:00:10.223Z","response_time":80,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloud","cloud-os","cloud-storage","desktop","desktop-environment","dropbox","good-first-issue","gui","javascript","nas","open-source","operating-system","os","osjs","puter","remote-desktop","storage","web-desktop","web-os","webtop"],"created_at":"2024-09-24T20:02:54.818Z","updated_at":"2025-09-09T20:40:32.875Z","avatar_url":"https://github.com/HeyPuter.png","language":"JavaScript","readme":"\u003ch3 align=\"center\"\u003e\u003cimg 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\"\u003e\u003c/h3\u003e\n\n\u003ch3 align=\"center\"\u003eThe Internet OS! Free, Open-Source, and Self-Hostable.\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://puter.com/?ref=github.com\"\u003e\u003cstrong\u003e« LIVE DEMO »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://puter.com/?ref=github.com\"\u003ePuter.com\u003c/a\u003e\n    ·\n    \u003ca href=\"https://puter.com/app/app-center\"\u003eApp Store\u003c/a\u003e\n    ·\n    \u003ca href=\"https://developer.puter.com\" target=\"_blank\"\u003eDevelopers\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/heyputer/puter-cli\" target=\"_blank\"\u003eCLI\u003c/a\u003e\n    ·\n    \u003ca href=\"https://discord.com/invite/PQcx7Teh8u\"\u003eDiscord\u003c/a\u003e\n    ·\n    \u003ca href=\"https://reddit.com/r/puter\"\u003eReddit\u003c/a\u003e\n    ·\n    \u003ca href=\"https://twitter.com/HeyPuter\"\u003eX\u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch3 align=\"center\"\u003e\u003cimg width=\"800\" style=\"border-radius:5px;\" alt=\"screenshot\" src=\"https://assets.puter.site/puter.com-screenshot-3.webp\"\u003e\u003c/h3\u003e\n\n\u003cbr/\u003e\n\n## Puter\n\nPuter is an advanced, open-source internet operating system designed to be feature-rich, exceptionally fast, and highly extensible. Puter can be used as:\n\n- A privacy-first personal cloud to keep all your files, apps, and games in one secure place, accessible from anywhere at any time.\n- A platform for building and publishing websites, web apps, and games.\n- An alternative to Dropbox, Google Drive, OneDrive, etc. with a fresh interface and powerful features.\n- A remote desktop environment for servers and workstations.\n- A friendly, open-source project and community to learn about web development, cloud computing, distributed systems, and much more!\n\n\u003cbr/\u003e\n\n## Getting Started\n\n### 💻 Local Development\n\n```bash\ngit clone https://github.com/HeyPuter/puter\ncd puter\nnpm install\nnpm start\n```\n**→** This should launch Puter at \n\u003cfont color=\"red\"\u003e http://puter.localhost:4100 (or the next available port). \u003c/font\u003e\n\n\n\nIf this does not work, see [First Run Issues](./doc/self-hosters/first-run-issues.md) for\ntroubleshooting steps.\n\n\u003cbr/\u003e\n\n### 🐳 Docker\n\n```bash\nmkdir puter \u0026\u0026 cd puter \u0026\u0026 mkdir -p puter/config puter/data \u0026\u0026 sudo chown -R 1000:1000 puter \u0026\u0026 docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter  ghcr.io/heyputer/puter\n```\n**→** This should launch Puter at \n\u003cfont color=\"red\"\u003e http://puter.localhost:4100 (or the next available port). \u003c/font\u003e\n\n\u003cbr/\u003e\n\n### 🐙 Docker Compose\n\n#### Linux/macOS\n\n```bash\nmkdir -p puter/config puter/data\nsudo chown -R 1000:1000 puter\nwget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml\ndocker compose up\n```\n**→** This should be available at \n\u003cfont color=\"red\"\u003e http://puter.localhost:4100 (or the next available port). \u003c/font\u003e\n\n\u003cbr/\u003e\n\n#### Windows\n\n```powershell\nmkdir -p puter\ncd puter\nNew-Item -Path \"puter\\config\" -ItemType Directory -Force\nNew-Item -Path \"puter\\data\" -ItemType Directory -Force\nInvoke-WebRequest -Uri \"https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml\" -OutFile \"docker-compose.yml\"\ndocker compose up\n```\n**→** This should launch Puter at \n\u003cfont color=\"red\"\u003e http://puter.localhost:4100 (or the next available port). \u003c/font\u003e\n\n\u003cbr/\u003e\n\n### 🚀 Self-Hosting\n\nFor 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).\n\n\u003cbr/\u003e\n\n### ☁️ Puter.com\n\nPuter is available as a hosted service at [**puter.com**](https://puter.com).\n\n\u003cbr/\u003e\n\n## System Requirements\n\n- **Operating Systems:** Linux, macOS, Windows\n- **RAM:** 2GB minimum (4GB recommended)\n- **Disk Space:** 1GB free space\n- **Node.js:** Version 16+ (Version 23+ recommended)\n- **npm:** Latest stable version\n\n\u003cbr/\u003e\n\n## Support\n\nConnect with the maintainers and community through these channels:\n\n- Bug report or feature request? Please [open an issue](https://github.com/HeyPuter/puter/issues/new/choose).\n- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)\n- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)\n- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)\n- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)\n- Security issues? [security@puter.com](mailto:security@puter.com)\n- Email maintainers at [hi@puter.com](mailto:hi@puter.com)\n\nWe are always happy to help you with any questions you may have. Don't hesitate to ask!\n\n\u003cbr/\u003e\n\n## License\n\nThis 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.\n\n\u003cbr/\u003e\n\n## Translations\n\n- [Arabic / العربية](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ar.md)\n- [Armenian / Հայերեն](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hy.md)\n- [Bengali / বাংলা](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.bn.md)\n- [Chinese / 中文](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.zh.md)\n- [Danish / Dansk](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.da.md)\n- [English](https://github.com/HeyPuter/puter/blob/main/README.md)\n- [Farsi / فارسی](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fa.md)\n- [Finnish / Suomi](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fi.md)\n- [French / Français](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.fr.md)\n- [German/ Deutsch](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.de.md)\n- [Hebrew/ עברית](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.he.md)\n- [Hindi / हिंदी](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hi.md)\n- [Hungarian / Magyar](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.hu.md)\n- [Indonesian / Bahasa Indonesia](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.id.md)\n- [Italian / Italiano](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.it.md)\n- [Japanese / 日本語](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.jp.md)\n- [Korean / 한국어](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ko.md)\n- [Malayalam / മലയാളം](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ml.md)\n- [Polish / Polski](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.pl.md)\n- [Portuguese / Português](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.pt.md)\n- [Romanian / Română](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ro.md)\n- [Russian / Русский](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ru.md)\n- [Spanish / Español](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.es.md)\n- [Swedish / Svenska](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.sv.md)\n- [Tamil / தமிழ்](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ta.md)\n- [Telugu / తెలుగు](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.te.md)\n- [Thai / ไทย](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.th.md)\n- [Turkish / Türkçe](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.tr.md)\n- [Ukrainian / Українська](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ua.md)\n- [Urdu / اردو](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.ur.md)\n- [Vietnamese / Tiếng Việt](https://github.com/HeyPuter/puter/blob/main/doc/i18n/README.vi.md)\n","funding_links":["https://github.com/sponsors/HeyPuter"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheyputer%2Fputer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fheyputer%2Fputer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheyputer%2Fputer/lists"}