mirror of
https://github.com/mynodebtc/mynode.git
synced 2024-12-27 06:54:00 +00:00
Update README
This commit is contained in:
parent
55f39a300d
commit
5831b3d5ee
79
README.md
79
README.md
|
@ -76,12 +76,9 @@ Each myNode device comes with a number of wonderful features:
|
||||||
We currently support images for the following devices:
|
We currently support images for the following devices:
|
||||||
- Raspberry Pi 4
|
- Raspberry Pi 4
|
||||||
- RockPro64
|
- RockPro64
|
||||||
- Virtual Machine Support (VirtualBox hosting Windows/OS X/Linux/Solaris, VMWare hosting Windows/OS X/Linux)
|
- Rock Pi 4
|
||||||
|
- PCs and Servers
|
||||||
## Deprecated Devices
|
- Virtual Machine Support (VirtualBox, VMWare)
|
||||||
Due to limited RAM and CPU power, following devices are no longer recommended for use. Performance may be poor.
|
|
||||||
- Raspberry Pi 3
|
|
||||||
- Rock64
|
|
||||||
|
|
||||||
## Running myNode
|
## Running myNode
|
||||||
You can run myNode on your own device in just a few easy steps!
|
You can run myNode on your own device in just a few easy steps!
|
||||||
|
@ -92,59 +89,23 @@ You can run myNode on your own device in just a few easy steps!
|
||||||
* Download [Etcher](https://www.balena.io/etcher/)
|
* Download [Etcher](https://www.balena.io/etcher/)
|
||||||
* Flash Downloaded Image
|
* Flash Downloaded Image
|
||||||
3. Insert SD Card, connect ethernet cable to router, and Boot your Device
|
3. Insert SD Card, connect ethernet cable to router, and Boot your Device
|
||||||
4. Attach External HD to Device
|
4. Attach External Drive to Device
|
||||||
* 1TB+ Required
|
* 1TB+ Required
|
||||||
5. Visit http://mynode.local/ or http://ip_of_device/
|
5. Visit http://mynode.local/ or http://ip_of_device/
|
||||||
|
|
||||||
## Developing for myNode
|
|
||||||
Once you are running myNode, you can easily modify and update the software yourself!
|
|
||||||
|
|
||||||
1. Start by running myNode on your device via the instructions above in "Running myNode"
|
|
||||||
2. Modify myNode files
|
|
||||||
* Clone this git repo on your PC or laptop - `git clone https://github.com/mynodebtc/mynode.git`
|
|
||||||
* Make your modifications
|
|
||||||
3. Run `make rootfs`
|
|
||||||
* Or run `make rootfs_auto` in a new console tab
|
|
||||||
* This will automatically create artifacts as local files are modified
|
|
||||||
4. Run 'make start_file_server'
|
|
||||||
* This will run a local HTTP server so your device can download files
|
|
||||||
5. On your device, run `sudo mynode-local-upgrade [dev pc ip address]`
|
|
||||||
* This will download your locally generated artifact and install it on your device
|
|
||||||
* Your device will automatically reboot to ensure updates take effect
|
|
||||||
6. Test your changes!
|
|
||||||
7. Submit Pull Request to share your updates!
|
|
||||||
|
|
||||||
### To update a subsystem without rebooting
|
|
||||||
Add another argument to the local upgrade script:
|
|
||||||
- To update files only, run `sudo mynode-local-upgrade [dev pc ip address] files`
|
|
||||||
- To update files and restart web server, run `sudo mynode-local-upgrade [dev pc ip address] www`
|
|
||||||
|
|
||||||
|
|
||||||
## Upgrading your myNode
|
## Upgrading your myNode
|
||||||
Once you are running myNode, you can easily update the software yourself!
|
Once you are running myNode, you can easily [update the software](https://mynodebtc.github.io/device/upgrading-device.html) yourself!
|
||||||
|
|
||||||
1. Start by running myNode on your device via the instructions above in "Running myNode"
|
|
||||||
2. Open 2 Terminal windows:
|
|
||||||
* 1 Terminal: Local PC or laptop
|
|
||||||
* 1 Terminal: ssh into your myNode device
|
|
||||||
* Command: `ssh admin@[myNode ip address]`
|
|
||||||
* Default credentials: admin/bolt
|
|
||||||
3. Clone the latest release from the git repo on your PC or laptop
|
|
||||||
* Run `git clone https://github.com/mynodebtc/mynode.git`
|
|
||||||
* Run `cd mynode`
|
|
||||||
* Run `git checkout tags/latest_release`
|
|
||||||
4. Run `make rootfs`
|
|
||||||
5. Run `make start_file_server`
|
|
||||||
* This will run a local HTTP server so your device can download files
|
|
||||||
6. On the other terminal which you used to ssh into your device, run `sudo mynode-local-upgrade [dev pc ip address]`
|
|
||||||
* This will download your locally generated artifact and install it on your device
|
|
||||||
* Your device will automatically reboot to ensure updates take effect
|
|
||||||
7. Optional: Run `make stop_file_server`
|
|
||||||
* This will stop the local HTTP server
|
|
||||||
8. You are now running the latest version of myNode software!
|
|
||||||
|
|
||||||
## Setup New Device (beta)
|
## Developing for myNode
|
||||||
To setup a new device on a supported platform (Raspi4, RockPi 4, RockPro64, PC, ...), you can run two simple commands.
|
See the [development guide](https://github.com/mynodebtc/mynode/blob/master/doc/development.md).
|
||||||
|
|
||||||
|
## Adding new Applications to myNode
|
||||||
|
To develop and add new applications to mynode, check out the [Software Development Kit (SDK)](https://github.com/mynodebtc/mynode_sdk).
|
||||||
|
|
||||||
|
|
||||||
|
## Install on Existing System (beta)
|
||||||
|
To setup a new device on a supported platform that is already running Linux (Raspi4, RockPi 4, RockPro64, PC, ...), you can run two simple commands.
|
||||||
|
|
||||||
First, install a debian-based operating system.
|
First, install a debian-based operating system.
|
||||||
|
|
||||||
|
@ -157,18 +118,6 @@ sudo bash ./mynode_setup.sh online
|
||||||
|
|
||||||
Once the script successfully completed, reboot and you will be running myNode!
|
Once the script successfully completed, reboot and you will be running myNode!
|
||||||
|
|
||||||
## Convert new device to run myNode
|
|
||||||
1. Run make command for your device. Ex:
|
|
||||||
* `make setup_new_rock64`
|
|
||||||
* `make setup_new_rockpro64`
|
|
||||||
* `make setup_new_raspi3`
|
|
||||||
* `make setup_new_raspi4`
|
|
||||||
* `make setup_new_debian`
|
|
||||||
* `make setup_new_other`
|
|
||||||
3. Follow Instructions
|
|
||||||
2. Reboot Device
|
|
||||||
4. Congratulations! You're running a new myNode device!
|
|
||||||
|
|
||||||
## Screenshots
|
## Screenshots
|
||||||
<img src="images/2.png" width="600">
|
<img src="images/2.png" width="600">
|
||||||
|
|
||||||
|
|
39
doc/development.md
Normal file
39
doc/development.md
Normal file
|
@ -0,0 +1,39 @@
|
||||||
|
# Developing for myNode
|
||||||
|
|
||||||
|
## Loading Modified Software
|
||||||
|
Once you are running myNode, you can easily modify and update the software yourself!
|
||||||
|
|
||||||
|
1. Start by running myNode on your device via the instructions above in "Running myNode"
|
||||||
|
2. Modify myNode files
|
||||||
|
* Clone this git repo on your PC or laptop - `git clone https://github.com/mynodebtc/mynode.git`
|
||||||
|
* Make your modifications
|
||||||
|
3. Run `make rootfs`
|
||||||
|
* Or run `make rootfs_auto` in a new console tab
|
||||||
|
* This will automatically create artifacts as local files are modified
|
||||||
|
4. Run 'make start_file_server'
|
||||||
|
* This will run a local HTTP server so your device can download files
|
||||||
|
5. On your device, run `sudo mynode-local-upgrade [dev pc ip address]`
|
||||||
|
* This will download your locally generated artifact and install it on your device
|
||||||
|
* Your device will automatically reboot to ensure updates take effect
|
||||||
|
6. Test your changes!
|
||||||
|
7. Submit Pull Request to share your updates!
|
||||||
|
|
||||||
|
### To update a subsystem without rebooting
|
||||||
|
Add another argument to the local upgrade script:
|
||||||
|
- To update files only, run `sudo mynode-local-upgrade [dev pc ip address] files`
|
||||||
|
- To update files and restart web server, run `sudo mynode-local-upgrade [dev pc ip address] www`
|
||||||
|
|
||||||
|
|
||||||
|
## Setup new device to run myNode
|
||||||
|
This steps will setup a new device and can be used for making images. These steps allow for updates to the `setup_device.sh` script that does the initial install.
|
||||||
|
|
||||||
|
1. Run make command for your device. Ex:
|
||||||
|
* `make setup_new_rock64`
|
||||||
|
* `make setup_new_rockpro64`
|
||||||
|
* `make setup_new_raspi3`
|
||||||
|
* `make setup_new_raspi4`
|
||||||
|
* `make setup_new_debian`
|
||||||
|
* `make setup_new_other`
|
||||||
|
3. Follow Instructions
|
||||||
|
2. Reboot Device
|
||||||
|
4. Congratulations! You're running a new myNode device!
|
Loading…
Reference in New Issue
Block a user