github_mirrors/puter
1
0
Fork 0
mirror of https://github.com/HeyPuter/puter.git synced 2025-02-02 23:28:39 +08:00
Code Issues Packages Projects Releases Wiki Activity
🌐 The Internet OS! Free, Open-Source, and Self-Hostable.
3,009 Commits 16 Branches 10 Tags 38 MiB
JavaScript 95.9%
CSS 2.5%
HTML 1.3%
Shell 0.2%
Dockerfile 0.1%
c1961dd54e
Go to file
KernelDeimos c1961dd54e dev: move app services to apps module 
Moves AppIconService, OldAppNameService, and ProtectedAppService to the
new apps module to keep things organized, and updates imports. There
were no interesting init errors. Services creating a database at init
were tested for failures but this wasn't an issue. It turns out
initializing with a database accessor before the db service inits is
okay, but using that database accessor at init is not.
2024-12-30 11:03:27 -05:00
.github Create FUNDING.yml 2024-11-10 08:48:12 -08:00
awesome Update #DoesItRunPuter.md 2024-12-03 12:05:19 -08:00
badges Add badges 2024-07-25 17:33:10 +02:00
doc Update README.zh.md 2024-12-13 12:13:10 +08:00
experiments clean: fix errors found by find-unused-exports 2024-12-06 15:40:59 -05:00
extensions tweak: load mods from extensions directory 2024-11-01 19:29:16 -04:00
mods dev: de-couple legacy mkdir and remove it 2024-12-03 13:04:12 -05:00
src dev: move app services to apps module 2024-12-30 11:03:27 -05:00
submodules sync: add wiki as a submodule 2024-10-31 18:08:30 -04:00
tools doc: generate and edit comments for tools 2024-12-06 13:05:03 -05:00
volatile Release backend 2024-03-30 19:08:03 -04:00
.dockerignore Fix Dockerfile 2024-04-15 19:03:00 -04:00
.env.example chore: format content 📝 2024-05-06 01:14:36 +00:00
.gitattributes Initial commit 2024-03-02 18:39:14 -08:00
.gitignore git: update .gitignore 2024-12-17 10:27:11 -05:00
.gitmodules sync: add wiki as a submodule 2024-10-31 18:08:30 -04:00
.is_puter_repository Release backend 2024-03-30 19:08:03 -04:00
addlicense.yml dev(tools): add license header adder thingy 2024-07-10 00:41:08 -04:00
CHANGELOG.md release: v2.4.2 2024-07-22 20:23:40 -04:00
CONTRIBUTING.md doc: update CONTRIBUTING.md 2024-12-04 16:33:45 -05:00
docker-compose.yml Update instructions & docker-compose to reflect production paths 2024-04-02 07:45:14 +02:00
Dockerfile Update Dockerfile 2024-07-18 13:33:02 -07:00
eslint.config.js Revert "Created test cases for issue #878 " 2024-12-08 11:31:47 -08:00
exports.js chore: add missing license headers 2024-07-09 04:10:33 -04:00
LICENSE.txt Initial commit 2024-03-02 18:39:14 -08:00
package-lock.json dev: add Amazon SNS integration 2024-12-23 14:53:18 -05:00
package.json dev: add ico support 2024-12-18 12:05:11 -05:00
README.md fix: remove inactive links in README 2024-11-26 13:39:42 -08:00
rust-toolchain.toml feat: v86 9p server support 2024-10-09 20:36:03 -04:00
SECURITY-ACKNOWLEDGEMENTS.md Add Ritesh Sahu to SECURITY-ACKNOWLEDGEMENTS.md 2024-12-29 10:24:33 -08:00
SECURITY.md minor documentation fixes 2024-10-30 16:36:43 +02:00

README.md

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.

test GitHub repo size GitHub Release GitHub License

« LIVE DEMO »

Puter.com · SDK · Discord · Reddit · X (Twitter)

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 will 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

🐙 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

🚀 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 22+ 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