Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dappnode/dappnode
General repository of the project dappnode
https://github.com/dappnode/dappnode
Last synced: 2 days ago
JSON representation
General repository of the project dappnode
- Host: GitHub
- URL: https://github.com/dappnode/dappnode
- Owner: dappnode
- License: gpl-3.0
- Created: 2018-02-27T18:59:48.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2024-12-10T08:06:01.000Z (13 days ago)
- Last Synced: 2024-12-10T08:31:54.546Z (13 days ago)
- Language: Shell
- Size: 26.4 MB
- Stars: 589
- Watchers: 49
- Forks: 104
- Open Issues: 87
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# DAppNode
[![Website dappnode.io](https://img.shields.io/badge/Website-dappnode.io-brightgreen.svg)](https://dappnode.io/)
[![Documentation Wiki](https://img.shields.io/badge/Documentation-Wiki-brightgreen.svg)](https://docs.dappnode.io)
[![GIVETH Campaign](https://img.shields.io/badge/GIVETH-Campaign-1e083c.svg)](https://beta.giveth.io/campaigns/5b44b198647f33526e67c262)
![GitHub All Releases](https://img.shields.io/github/downloads/dappnode/DAppNode/total.svg)
[![GitPOAP Badge](https://public-api.gitpoap.io/v1/repo/dappnode/DAppNode/badge)](https://www.gitpoap.io/gh/dappnode/DAppNode)
[![Twitter Follow](https://img.shields.io/twitter/follow/espadrine.svg?style=social&label=Follow)](https://twitter.com/DAppNODE?lang=es)
[![Discord](https://img.shields.io/discord/747647430450741309?logo=discord&style=plastic)](https://discord.gg/dappnode)
## Infrastructure for the decentralized world
DAppNode is empowering people by creating a simple, transparent system for hosting P2P clients for DApps, Cryptocurrencies, VPNs, IPFS and more
- Read about our purpose and mission on [Our Website](https://dappnode.com/)
- Join our community and find support on [Our Discord](https://discord.gg/dappnode)
- Check out what we are up to on [Our Medium](https://medium.com/dappnode)
- Share your ideas and find how to guides on [Our Forum](https://discourse.dappnode.io/)## Discover DAppNode
DAppNode lowers the barrier of entry for non tech-savvy participants. It allows you to deploy, update, and manage P2P clients and nodes without leaving your browser. No terminal or command line interface.
## Develop with DAppNode
DAppNode modular architecture allows any team to or project to publish a dockerized application to the DAppNode packages eco-system. Benefit from an enthusiastic crypto savvy user based and offer a user interface-only experience to lower onboarding friction.
Check out the [DAppNodeSDK](https://github.com/dappnode/DAppNodeSDK) to learn how to get started.
_Note: packages are published to Ethereum mainnet and incur costs. Given the current high gas prices the DAppNode team is willing to subsidize gas costs for packages of great interest to users._
## Packages eco-system
The community and core team members have created many useful packages for users. Checkout the [**package explorer**](https://explorer.dappnode.io) to browse an up-to-date list of all packages and their versions.
### Champions
Champions are community members that are in charge of maintaining packages: keeping them updated and working. All packages in this list without a champion are actively looking for a champion. Join our [DAppNode Discord **#champion-process**](https://discord.gg/dappnode) to suggest a package to be championed and/or offer to be a champion for a project you care about!
| Package | Champion |
| ---------------------------------------------------------------------------------------- | ---------------- |
| [Avalanche](https://github.com/Colm3na/DAppNodePackage-avalanche) | Wimel |
| [ARTIS-sigma1](https://github.com/lab10-coop/DAppNodePackage-ARTIS-sigma1) | - |
| [Bee](https://github.com/dappnode/DAppNodePackage-bee) | @tropicar |
| [Bitcoin](https://github.com/dappnode/DAppNodePackage-bitcoin) | @Pol-Lanski |
| [Block-explorer](https://github.com/dappnode/DappnodePackage-block-explorer) | - |
| [Cosmos](https://github.com/Colm3na/DAppNodePackage-cosmos) | Wimel |
| [DMS](https://github.com/dappnode/DAppNodePackage-DMS) | @eduadiez |
| [Eth2stats-client](https://github.com/dappnode/DAppNodePackage-eth2stats-client) | - |
| [Ethereum Classic](https://github.com/dappnode/DAppNodePackage-ethereum-classic) | - |
| [Ethereum Optimism](https://github.com/dappnode/DAppNodePackage-ethereum-optimism) | - |
| [Exporter](https://github.com/dappnode/DAppNodePackage-exporter) | @eduadiez |
| [Geth](https://github.com/dappnode/DAppNodePackage-geth) | @pablomendezroyo |
| [Goerli Geth](https://github.com/dappnode/DAppNodePackage-goerli-geth) | @pablomendezroyo |
| [HTTPs Portal](https://github.com/dappnode/DAppNodePackage-https-portal) | @3alpha |
| [Ipfs Cluster](https://github.com/dappnode/DAppNodePackage-ipfs-cluster) | @dapplion |
| [Ipfs Pinner](https://github.com/dappnode/DAppNodePackage-ipfs-pinner) | @dapplion |
| [Kovan](https://github.com/dappnode/DAppNodePackage-kovan) | @pablomendezroyo |
| [LightningNetwork](https://github.com/dappnode/DAppNodePackage-LightningNetwork) | @pablomendezroyo |
| [Matrix](https://github.com/dappnode/DAppNodePackage-matrix) | - |
| [Metrics Tools](https://github.com/dappnode/DAppNodePackage-metrics-tools) | @eduadiez |
| [Monero](https://github.com/dappnode/DAppNodePackage-monero) | @pablomendezroyo |
| [Nethermind](https://github.com/dappnode/DAppNodePackage-nethermind) | @pablomendezroyo |
| [Openethereum](https://github.com/dappnode/DAppNodePackage-openethereum) | @pablomendezroyo |
| [Owncloud](https://github.com/dappnode/DAppNodePackage-owncloud) | @tropicar |
| Polkadot Kusama | - |
| [Prysm](https://github.com/dappnode/DAppNodePackage-prysm) | @pablomendezroyo |
| [Prysm Pyrmont](https://github.com/dappnode/DAppNodePackage-prysm-pyrmont) | @pablomendezroyo |
| [Raiden](https://github.com/dappnode/DAppNodePackage-raiden) | @eduadiez |
| [Raiden Testnet](https://github.com/dappnode/DAppnodePackage-raiden-testnet) | @eduadiez |
| [Rinkeby](https://github.com/dappnode/DAppNodePackage-rinkeby) | @pablomendezroyo |
| [Ropsten](https://github.com/dappnode/DAppNodePackage-ropsten) | @pablomendezroyo |
| [Storj](https://github.com/dappnode/DAppNodePackage-storj) | @pablomendezroyo |
| [Tornado Cash Relayer](https://github.com/dappnode/DAppNodePackage-Tornado-Cash-Relayer) | - |
| [Trustlines](https://github.com/dappnode/DAppNodePackage-trustlines) | - |
| [Turbo-geth](https://github.com/dappnode/DAppNodePackage-turbo-geth) | @gnidan |
| [Vipnode](https://github.com/dappnode/DAppNodePackage-vipnode) | - |
| [Wireguard](https://github.com/dappnode/DAppNodePackage-wireguard) | @3alpha |
| [ZCash](https://github.com/dappnode/DAppNodePackage-zcash) | - |## Core packages
- [DNP_DAPPMANAGER](https://github.com/dappnode/DNP_DAPPMANAGER)
- [DNP_VPN](https://github.com/dappnode/DNP_VPN)
- [DNP_IPFS](https://github.com/dappnode/DNP_IPFS)
- [DNP_BIND](https://github.com/dappnode/DNP_BIND)
- [DNP_WIREGUARD](https://github.com/dappnode/DNP_WIREGUARD)
- [DNP_HTTPS](https://github.com/dappnode/DNP_HTTPS)## Get DAppNode
Get your DAppNode and start contributing to decentralization by running your own nodes.
[Install DAppNode on your host machine](https://docs.dappnode.io/user/quick-start/Core/installation) or buy your DAppNode with all the stuff configured and prepared to be used in [DAppNode shop](https://dappnode.com/en-us/collections/frontpage)
### Install DAppNode with ISO
DAppNode ISO available is in: [latest DAppNode release](https://github.com/dappnode/DAppNode/releases).
Install DAppNode on your host machine by burning DAppNode ISO to a DVD or creating a bootable USB. Follow the tutorial of your operating system below and come back when you are finished:
- [MacOS](https://tutorials.ubuntu.com/tutorial/tutorial-create-a-usb-stick-on-macos)
- [Windows](https://tutorials.ubuntu.com/tutorial/tutorial-create-a-usb-stick-on-windows)
- [Ubuntu](https://tutorials.ubuntu.com/tutorial/tutorial-create-a-usb-stick-on-ubuntu)**Developers**: DAppNode ISO could be generated following these steps:
```bash
git clone https://github.com/dappnode/DAppNode.git
cd DAppNode
docker compose build
docker compose up
```DAppNode iso will be generated inside images folder, to verify it:
```bash
ls -lrt images/DAppNode-*
```_Note_: ISO could be generated as unattended/attended by editing the env var available in the docker-compose.yml file
### Install DAppNode with scripts
Scripts are available in: [latest DAppNode release](https://github.com/dappnode/DAppNode/releases).
DAppNode could be also installed on a host machine with an OS already running on it. DAppNode has been developed and configured to be run on Debian host machines. Therefore, it should work on Debian or Debian based (like Ubuntu) host machines. Minimum recommended Debian version is 11.
**1. Prerequisites**
Before installing DAppNode with the script option, make sure you fulfill the requirements by running the following script:
```bash
sudo wget -O - https://prerequisites.dappnode.io | sudo bash
```**2. Script installation**
Once you make sure you have the requirements, install DAPpNode with the installation script:
```bash
sudo wget -O - https://installer.dappnode.io | sudo bash
```**3. Uninstall DAppNode**
Uninstall DAppNode from your host machine by running the following command:
```bash
wget -qO - https://uninstaller.dappnode.io | sudo bash
```**4. Update DAppNode from scripts**
To update DAppNode to the latest version using script:
```bash
sudo wget -O - https://installer.dappnode.io | sudo UPDATE=true bash
```## Releases
Create releases manually with Github actions, the Github action to run is: **Pre-release**. The requirements are:
- Introduce the core packages versions
- There must exist the corresponding core package release for the specified versionThe release will contain:
- Assets:
- Scripts: `dappnode_access_credentials.sh`, `dappnode_install.sh`, `dappnode_uninstall.sh`, `dappnode_install_pre.sh`, `dappnode_profile.sh`
- ISOs: `DAppNode-vX-debian-bullseye-amd64-unattended.iso`, `DAppNode-vX-debian-bullseye-amd64-unattended.iso`
- Release body:
- Table with core packages versions
- Changes section
- SHASUMs for unattended and attended ISOs
- Default credentials## Testing with artifacts
Generate ISOs and test them by running the Github action: **Artifacts**. This action will generate an artifacts with the same assets as the release, useful for testing purposes.
## Versioning
We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/dappnode/DAppNode/tags).
## Team members
Members of the [White Hat Group (WHG)](https://motherboard.vice.com/en_us/article/qvp5b3/how-ethereum-coders-hacked-back-to-rescue-dollar208-million-in-ethereum) have spent countless hours bootstrapping and developing DAppNode in 2017. Currently, the project is maintained by a growing multi-disciplinary team:
- **Adviser & Instigator:** Jordi Baylina
- **Project Lead:** Eduadiez
- **Developer Lead:** dapplion
- **Ecosystem Development** Pol Lanski
- **Developer:** Pablo
- **Developer:** Carlos
- **Adviser:** Griff Green## License
This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details
## Copyright
Copyright © (2018-2023) [The DAppNode Association](https://dappnode.com)