{"id":13583477,"url":"https://github.com/project-rainstorm/rainstorm","last_synced_at":"2025-04-06T21:32:04.734Z","repository":{"id":56093256,"uuid":"290347283","full_name":"project-rainstorm/rainstorm","owner":"project-rainstorm","description":"The easiest way to own your cloud. Your data. Your cloud. Rainstorm.","archived":false,"fork":false,"pushed_at":"2021-01-28T03:23:46.000Z","size":620,"stargazers_count":10,"open_issues_count":13,"forks_count":5,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-11-06T00:39:05.354Z","etag":null,"topics":["automation","cloud","docker-compose","raspberry-pi","self-hosted","services"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/project-rainstorm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-08-25T23:38:23.000Z","updated_at":"2023-07-05T10:14:05.000Z","dependencies_parsed_at":"2022-08-15T13:00:58.100Z","dependency_job_id":null,"html_url":"https://github.com/project-rainstorm/rainstorm","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/project-rainstorm%2Frainstorm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/project-rainstorm%2Frainstorm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/project-rainstorm%2Frainstorm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/project-rainstorm%2Frainstorm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/project-rainstorm","download_url":"https://codeload.github.com/project-rainstorm/rainstorm/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247555558,"owners_count":20957794,"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","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":["automation","cloud","docker-compose","raspberry-pi","self-hosted","services"],"created_at":"2024-08-01T15:03:30.457Z","updated_at":"2025-04-06T21:32:04.370Z","avatar_url":"https://github.com/project-rainstorm.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"![Rainstorm Logo](docs/img/logo.png)\n\nThe easiest way to own your cloud. Your data. Your cloud. Rainstorm.\n\n## Getting Started\n\nHead over to our downloads page to download an image for your device.\nAlternatively, you can install on your own device (see Build Instructions)\n\n## Overview\n\nRainstorm aims to be the easiest way to to run a dedicated, easy to use,\nhome server leveraging many popular and open source cloud alternatives that give you complete ownership and control of your data.\n\nWith the increasing power and affordability of small board computers like the Raspberry Pi, we believe it's finally feasible for everyone to own their cloud instead of giving everything they own to the cloud.\n\nBy running Rainstorm, you can quickly and cheaply deploy your own cloud infrastructure all from the web browser with ZERO terminal commands necessary.\n\n## Features\n\nEach installation of Rainstorm enables a number of wonderful features.\n\n- Plex Media Server\n- Transmission Torrent Client\n- Filebrowser\n- Minecraft Server\n- Pi-hole\n\nIn the future, we'd also like to have...\n\n- Data backup solutions\n- Bitwarden Password Manager\n- Nextcloud\n- Wordpress Site\n- Matrix chat server\n- WireGaurd VPN\n- Tor Relay\n- Bitcoin Full Node\n- Jitsi Server\n- Email server\n- Any service from [this list of open source projects](https://github.com/awesome-selfhosted/awesome-selfhosted) can also be added.\n\n- ...and many more features!\n\n## Screenshots\n\n|            Home Screen            |             Service View              |             Device Settings             |\n| :-------------------------------: | :-----------------------------------: | :-------------------------------------: |\n| ![Home Screen](docs/img/home.png) | ![Service View](docs/img/service.png) | ![Settings Page](docs/img/settings.png) |\n\n## Supported Devices\n\n- Raspberry Pi 4\n\n## Adding a Service\n\nRainstorm uses docker-compose for services. Pull requests are welcome. Checkout the [Services README.md](services/README.md) for more info on how to create services for Rainstorm.\n\n## Running Rainstorm\n\nYou can run Rainstorm on your own device in just a few easy steps!\n\n1. Download an image from our downloads page.\n\n2. Flash image onto SD card\n\n- Download [Etcher](https://www.balena.io/etcher/)\n- Flash downloaded image\n\n3. Insert SD card and attach external HD (highly recommended) to device\n\n4. Boot your device and visit http://rainstorm.local or http://ip_of_device/\n\n## Build Instructions\n\nYou can also run Rainstorm on your own.\n\nDownload the `config.yml`.\n\n`curl -fsSL https://raw.githubusercontent.com/project-rainstorm/rainstorm/master/config.yml -o config.yml`\n\nDownload the setup script in the same directory as `config.yml`\n\n`curl -fsSL https://raw.githubusercontent.com/project-rainstorm/rainstorm/master/scripts/setup.sh -o setup.sh`\n\n**WARNING** Running this script will make changes to your system. This is meant to be run on a dedicated device with a freshly installed OS (RPi4 running Raspberry Pi OS Lite recommended. You are responsible for what you run.)\n\n`bash setup.sh`\n\nIf you are a developer\n\n`bash setup.sh --dev`\n\nThe script will walk you thru the installation. Check for any errors in the log. \n\n`sudo reboot`\n\nLog back in as the default user `drop` with password `drop`. \n\nOr log in with the user/password you set in `config.yml`\n\nNow you can clone this repo in your home directory\n\n`cd \u0026\u0026 git clone https://github.com/project-rainstorm/rainstorm.git `\n\n## Development Setup\n\nAfter following the build instructions, you can run the app in development.\n\nTo run the API:\n\n- 1. Create a virtual environemnt `python3 -m venv env`\n\n- 2. Activate the virtual environment `source env/bin/activate`\n\n- 3. Install packages `pip3 install -r requirements.txt`\n\n- 4. `bash run_server.sh`\n\nTo run the react server:\n\n- 1. `cd thunder`\n\n- 2. Install packages `yarn install`\n\n- 3. `yarn start`\n\nVisit `http://rainstrorm.local:3000` \n\n## Contributing\n\nThe contribution workflow is described in [CONTRIBUTING.md](docs/CONTRIBUTING.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fproject-rainstorm%2Frainstorm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fproject-rainstorm%2Frainstorm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fproject-rainstorm%2Frainstorm/lists"}