create account

SPK Testnet Node Setup Guide by spknetwork

View this thread on: hive.blogpeakd.comecency.com
· @spknetwork · (edited)
$48.97
SPK Testnet Node Setup Guide
### Introduction

This guide will walk you through setting up an SPK Testnet node. SPK is a decentralized file storage network built on the Hive blockchain.

![spkcovertestnetnguide.png](https://files.peakd.com/file/peakd-hive/spknetwork/23uQmv2gdggBGLzjPSkWxeR7vChbgfhfnUhZZocsf2UckHHr6QksnD9miHr19YPzd5iKB.png)

### Prerequisites

- Have TEST LARYNX Tokens
  - Follow @spknetwork on any [Hive frontend](https://hive.io/eco?t=social) to obtain TEST LARYNX tokens (unfollow and refollow for additional tokens).

### Simple SPK Storage Node

This is the base model for the SPK ecosystem. It allows anybody with a computer and an internet connection to participate. This setup is extremely simple but requires you to have Docker, which is a way to run compartmentalized virtual machines. [Get Docker](https://docs.docker.com/get-docker/)

- Then [download Trole](https://github.com/spknetwork/trole)

![The Code button displays download options](https://files.peakd.com/file/peakd-hive/spknetwork/Eo4Jn5CL7qs5Ft1JFoU3biJu2FoE26fKPfMT7MreidUgqWnBTZMatw4DAfejPmke6vA.png)

Next, copy `env.sample` to `.env` and write your spknetwork hive account and active key in the coppied file.
- copy and paste the env.sample file, open it with a text editor like Notepad, and fill in the account information.
- Make sure you rename this file to `.env`
  - This might make the file invisible on your computer


Now run the build and up

- `docker-compose build`

- `docker-compose up`

You should now be able to store the files in contracts you might see around Hive.

### To Earn Test BROCA and Test SPK

To manage your node, you can follow this [link: localhost:5050](http://localhost:5050)
- This link will only work from a computer with the software running on it.
  - Ports 4000(IPFS), 5001(IPFS), 5050(Trole), 8000(PoA), and 8080(IPFS) will be used.

### Full Install Step-by-Step Instructions (Including Validator Node)

This install path is for developers who want to test the whole ecosystem. In addition to the above software, it will run a validator and an SPK Network node. This validator MUST be on a public address so the rest of the network can talk to it. You will also be able to accept uploads to the SPK Network and have the first chance at grabbing a lucrative spot on a storage contract. If you run any server, this should be easy; if you're capable with a computer, it shouldn't be too hard.

#### Full Install Prerequisites
- Ubuntu Server
- Domain name (stick to poa, spk, ipfs subdomains)
#### 1. Set Up Your Server
- **Create a Server:** Use Ubuntu 20.04 LTS on a service like DigitalOcean.
- **SSH Access:** Log in to your server using Terminus or any SSH terminal.

![Screenshot 2023-12-01 at 10.19.06 AM.png](https://files.peakd.com/file/peakd-hive/retzark/EoASbvXbd17T5GJtCPZF2iHBoxuRsG7hzw6RTTKtMSTq863f9ZMpP1Cf37ndeBgEqLp.png)

#### 2. Create User
- **Add User:** 
  ```
  sudo adduser spk
  ```
- **Set Password:** Follow the prompts to set a new password.
- **Grant Permissions:** 
  ```
  sudo usermod -aG sudo spk
  ```
- **Switch User:** 
  ```
  su spk
  ```

![root@ubuntu-s-1vcpu-1gb-sgp1-01~# sudo adduser spk.png](https://files.peakd.com/file/peakd-hive/retzark/23tGPUBvFwJ5JT9xJFjzmzarDLsxCovkXX5z3c2EY6nLRoNMThGY5cRkoJYSPg1boAug3.png)

#### 3. Domain Configuration
- **DNS Setup:** Configure your domain's subdomains with Cloudflare or your DNS provider. A records should be set for:
  - spk.retzark.spk.tv
  - ipfs.retzark.spk.tv
  - poa.retzark.spk.tv
- The install script will register poa ipfs and spk subdomains to your domain. We recommend sticking to these presets.

![Screenshot 2023-12-01 at 10.42.02 AM.png](https://files.peakd.com/file/peakd-hive/retzark/23tmmjqrjZv1KfN1HsGDJpJFNDVCx4jpAJB23EkYV3TBy4A6EUe5dB2mTKfjQCkzWJqAN.png)

#### 4. Install SPK
- **Navigate to Home Directory:** 
  ```
  cd
  ```
- **Clone Repository:** 
  ```
  git clone https://github.com/spknetwork/trole.git && cd trole
  ```
- **Run Installer:** 
  ```
  ./install.sh
  ```

#### 5. Configuration
- When prompted for a domain name, enter retzark.spk.tv.
- Choose your installation options:
  - **File Storage only (No SPK Node and No Validator):** Respond with `N`.
  - **Register a Validator:** Respond with `Y`.

![Screenshot 2023-12-01 at 10.45.04 AM.png](https://files.peakd.com/file/peakd-hive/retzark/23t77FWjXGZXWPVoFKLN2uqCNVyVMJ48GmebjbrHQKnvJKkj86dHeGPHaugiL2QGpUPdh.png)
#### 6. Hive Account Setup
- Enter your Hive account name and active key when prompted.
- For SPK keypair, select `N` to generate a new one.

![Screenshot 2023-12-01 at 10.48.57 AM.png](https://files.peakd.com/file/peakd-hive/retzark/23t6zySwUwnpJuYZtAkaJkug1oxKRvadTiRcfHvdTXSy24v4ysWAZ4jPGusRkapERA43E.png)

#### 7. Service Status Check
- Verify services are running with:
  ```
  systemctl status ipfs
  systemctl status spk
  systemctl status poa
  systemctl status poav
  ```
- If any services aren't running, restart them using:
  ```
  systemctl restart [service_name]
  ```

![Screenshot 2023-12-01 at 11.09.42 AM.png](https://files.peakd.com/file/peakd-hive/retzark/23t6zbQKMbyMcqccBhjrKWdBDSZDs9wWJhTm7rsaLKeABitJz9ajKn84YW3jjTBz63LXj.png)

#### 8. Uploading Files to SPK Network
- Visit Dlux.
- Power up SPK and create a contract.

![0.000 SPK.png](https://files.peakd.com/file/peakd-hive/retzark/23uQJEXgmxTo9LPL6o5dmrXZgSBXG44dc5cn774tsoJAJzvDzZBeahhnBoE59m2E61VGt.png)

![Create Contract.png](https://files.peakd.com/file/peakd-hive/retzark/23t7F8NVCiXyZVqw1mNALnhUVdquLrZYUrAHAVCMqnPF2oAoiAgZoNVNtDUgzL4GbCcDT.png)

- Wait for the contract to be built, then add and upload files.

![spkcc_channel_open.png](https://files.peakd.com/file/peakd-hive/retzark/48o4uWVWTm4TJxDqfVDABR9MNs9qSh1DgFt71tLSoavhKJXaD9g4hZpEeb7aksGdVy.png)
- Sign and upload

![game-board-ability (1)-png.png](https://files.peakd.com/file/peakd-hive/retzark/Eo8L2GCbPDrijHjNAnjFUsGj4YuApsCFqVZ43MuSGowxZRFp3zE47sQvTrWRbTL3a2S.png)

- Wait then refresh the page after the image is successfully uploaded 


![1.854436 MB.png](https://files.peakd.com/file/peakd-hive/retzark/Eoe8FCyc2XAJBZbPAYsh9tQpGtcAoFsE6i39j1V5igshiD3t6Hy62Qc5XXyeFjh2Pvv.png)


- Create a post that with you’re uploaded image


![Screenshot 2023-12-01 at 6.14.23 PM.png](https://files.peakd.com/file/peakd-hive/retzark/23wWke4bvYeGoVsRv8X7agS68JaRRN4kf5VW3pDe3DXSFzMSWPv4NcR41z2aumVCjpyoG.png)

#### SPK Storage Dashboard
At spk.your.domain you should find the storage node panel. This panel allows limited storage management with your hive keys and keychain. You can for example: store newfound contracts, explore and remove existing contracts (files), and see your SPK network balances.

### Conclusion
After following these steps, your SPK Testnet node should be up and running. For any issues or further assistance, refer to the SPK Network Discord Server or Telegram Group, you can find the links below.

---

#### About the SPK Network:

>The SPK Network is a decentralized Web 3.0 protocol that rewards value creators and infrastructure providers appropriately and autonomously by distributing reward tokens so that every user, creator, and platform can earn rewards on a level playing field.

- Check out the SPK Network Light Paper: https://peakd.com/hive/@spknetwork/spk-network-light-paper

- Visit our website: https://spk.network/

- Telegram Group: https://t.me/spknetwork

- Discord Server: https://discord.gg/JbhQ7dREsP

- https://linktr.ee/spknetwork

- https://linktr.ee/proofofaccess

- [SPK Network Proposal 2023](https://peakd.com/hive-112019/@spknetwork/spk-network-funding-proposal-2023)
👍  , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , and 353 others
properties (23)
authorspknetwork
permlinkspk-testnet-node-setup-guide
categoryhive-112019
json_metadata{"app":"peakd/2023.11.3","author":"nathansenn","format":"markdown","image":["https://files.peakd.com/file/peakd-hive/spknetwork/23uQmv2gdggBGLzjPSkWxeR7vChbgfhfnUhZZocsf2UckHHr6QksnD9miHr19YPzd5iKB.png","https://files.peakd.com/file/peakd-hive/spknetwork/Eo4Jn5CL7qs5Ft1JFoU3biJu2FoE26fKPfMT7MreidUgqWnBTZMatw4DAfejPmke6vA.png","https://files.peakd.com/file/peakd-hive/retzark/EoASbvXbd17T5GJtCPZF2iHBoxuRsG7hzw6RTTKtMSTq863f9ZMpP1Cf37ndeBgEqLp.png","https://files.peakd.com/file/peakd-hive/retzark/23tGPUBvFwJ5JT9xJFjzmzarDLsxCovkXX5z3c2EY6nLRoNMThGY5cRkoJYSPg1boAug3.png","https://files.peakd.com/file/peakd-hive/retzark/23tmmjqrjZv1KfN1HsGDJpJFNDVCx4jpAJB23EkYV3TBy4A6EUe5dB2mTKfjQCkzWJqAN.png","https://files.peakd.com/file/peakd-hive/retzark/23t77FWjXGZXWPVoFKLN2uqCNVyVMJ48GmebjbrHQKnvJKkj86dHeGPHaugiL2QGpUPdh.png","https://files.peakd.com/file/peakd-hive/retzark/23t6zySwUwnpJuYZtAkaJkug1oxKRvadTiRcfHvdTXSy24v4ysWAZ4jPGusRkapERA43E.png","https://files.peakd.com/file/peakd-hive/retzark/23t6zbQKMbyMcqccBhjrKWdBDSZDs9wWJhTm7rsaLKeABitJz9ajKn84YW3jjTBz63LXj.png","https://files.peakd.com/file/peakd-hive/retzark/23uQJEXgmxTo9LPL6o5dmrXZgSBXG44dc5cn774tsoJAJzvDzZBeahhnBoE59m2E61VGt.png","https://files.peakd.com/file/peakd-hive/retzark/23t7F8NVCiXyZVqw1mNALnhUVdquLrZYUrAHAVCMqnPF2oAoiAgZoNVNtDUgzL4GbCcDT.png","https://files.peakd.com/file/peakd-hive/retzark/48o4uWVWTm4TJxDqfVDABR9MNs9qSh1DgFt71tLSoavhKJXaD9g4hZpEeb7aksGdVy.png","https://files.peakd.com/file/peakd-hive/retzark/Eo8L2GCbPDrijHjNAnjFUsGj4YuApsCFqVZ43MuSGowxZRFp3zE47sQvTrWRbTL3a2S.png","https://files.peakd.com/file/peakd-hive/retzark/Eoe8FCyc2XAJBZbPAYsh9tQpGtcAoFsE6i39j1V5igshiD3t6Hy62Qc5XXyeFjh2Pvv.png","https://files.peakd.com/file/peakd-hive/retzark/23wWke4bvYeGoVsRv8X7agS68JaRRN4kf5VW3pDe3DXSFzMSWPv4NcR41z2aumVCjpyoG.png"],"tags":["spknetwork","proofofacces","poa","hive","web3","blockchain","leofinance","ctp","testnet","spk"],"users":["spknetwork","ubuntu-s-1vcpu-1"]}
created2023-12-09 20:06:06
last_update2023-12-13 17:35:15
depth0
children11
last_payout2023-12-16 20:06:06
cashout_time1969-12-31 23:59:59
total_payout_value0.000 HBD
curator_payout_value48.965 HBD
pending_payout_value0.000 HBD
promoted0.000 HBD
body_length7,564
author_reputation348,970,601,774,222
root_title"SPK Testnet Node Setup Guide"
beneficiaries
0.
accountdisregardfiat
weight2,500
1.
accountnathansenn
weight7,500
max_accepted_payout1,000,000.000 HBD
percent_hbd10,000
post_id129,541,555
net_rshares207,423,282,652,226
author_curate_reward""
vote details (417)
@fonestreet ·
Reading updates
properties (22)
authorfonestreet
permlinkre-spknetwork-2024610t135327124z
categoryhive-112019
json_metadata{"tags":["spknetwork","proofofacces","poa","hive","web3","blockchain","leofinance","ctp","testnet","spk"],"app":"ecency/3.2.0-vision","format":"markdown+html"}
created2024-06-10 17:53:30
last_update2024-06-10 17:53:30
depth1
children0
last_payout2024-06-17 17:53:30
cashout_time1969-12-31 23:59:59
total_payout_value0.000 HBD
curator_payout_value0.000 HBD
pending_payout_value0.000 HBD
promoted0.000 HBD
body_length15
author_reputation161,927,554,904,962
root_title"SPK Testnet Node Setup Guide"
beneficiaries[]
max_accepted_payout1,000,000.000 HBD
percent_hbd10,000
post_id134,463,345
net_rshares0
@hivebuzz ·
Congratulations @spknetwork! You have completed the following achievement on the Hive blockchain And have been rewarded with New badge(s)

<table><tr><td><img src="https://images.hive.blog/60x70/http://hivebuzz.me/@spknetwork/comments.png?202312111450"></td><td>You made more than 50 comments.<br>Your next target is to reach 100 comments.</td></tr>
</table>

<sub>_You can view your badges on [your board](https://hivebuzz.me/@spknetwork) and compare yourself to others in the [Ranking](https://hivebuzz.me/ranking)_</sub>
<sub>_If you no longer want to receive notifications, reply to this comment with the word_ `STOP`</sub>

properties (22)
authorhivebuzz
permlinknotify-spknetwork-20231211t150649
categoryhive-112019
json_metadata{"image":["http://hivebuzz.me/notify.t6.png"]}
created2023-12-11 15:06:48
last_update2023-12-11 15:06:48
depth1
children0
last_payout2023-12-18 15:06:48
cashout_time1969-12-31 23:59:59
total_payout_value0.000 HBD
curator_payout_value0.000 HBD
pending_payout_value0.000 HBD
promoted0.000 HBD
body_length629
author_reputation369,385,327,990,969
root_title"SPK Testnet Node Setup Guide"
beneficiaries[]
max_accepted_payout1,000,000.000 HBD
percent_hbd10,000
post_id129,586,795
net_rshares0
@jjobo ·
All good! Everything will be great if you keep going
@ [wordle unlimited](https://wordleunlimited.io)
properties (22)
authorjjobo
permlinks5hf0z
categoryhive-112019
json_metadata{"links":["https://wordleunlimited.io"],"app":"hiveblog/0.1"}
created2023-12-11 03:00:36
last_update2023-12-11 03:00:36
depth1
children0
last_payout2023-12-18 03:00:36
cashout_time1969-12-31 23:59:59
total_payout_value0.000 HBD
curator_payout_value0.000 HBD
pending_payout_value0.000 HBD
promoted0.000 HBD
body_length101
author_reputation0
root_title"SPK Testnet Node Setup Guide"
beneficiaries[]
max_accepted_payout1,000,000.000 HBD
percent_hbd10,000
post_id129,573,233
net_rshares0
@latinowinner ·
DYO on the project before considering investing on it
👍  
properties (23)
authorlatinowinner
permlinkre-spknetwork-20231210t71238984z
categoryhive-112019
json_metadata{"tags":["spknetwork","proofofacces","poa","hive","web3","blockchain","leofinance","ctp","testnet","spk"],"app":"ecency/3.0.37-vision","format":"markdown+html"}
created2023-12-09 21:12:39
last_update2023-12-09 21:12:39
depth1
children0
last_payout2023-12-16 21:12:39
cashout_time1969-12-31 23:59:59
total_payout_value0.000 HBD
curator_payout_value0.000 HBD
pending_payout_value0.000 HBD
promoted0.000 HBD
body_length53
author_reputation2,903,232,047,608
root_title"SPK Testnet Node Setup Guide"
beneficiaries[]
max_accepted_payout1,000,000.000 HBD
percent_hbd10,000
post_id129,542,712
net_rshares0
author_curate_reward""
vote details (1)
@rishi556 ·
Why no IPv6 on the dns entries?
properties (22)
authorrishi556
permlinkre-spknetwork-s5f1kl
categoryhive-112019
json_metadata{"tags":["hive-112019"],"app":"peakd/2023.11.3"}
created2023-12-09 20:14:45
last_update2023-12-09 20:14:45
depth1
children2
last_payout2023-12-16 20:14:45
cashout_time1969-12-31 23:59:59
total_payout_value0.000 HBD
curator_payout_value0.000 HBD
pending_payout_value0.000 HBD
promoted0.000 HBD
body_length31
author_reputation132,739,675,638,017
root_title"SPK Testnet Node Setup Guide"
beneficiaries[]
max_accepted_payout1,000,000.000 HBD
percent_hbd10,000
post_id129,541,736
net_rshares0
@disregardfiat ·
Feel free to add them, I don't think it will break anything and caddy should set up the reverse proxy just fine.
properties (22)
authordisregardfiat
permlinkre-rishi556-s5f3qc
categoryhive-112019
json_metadata{"tags":["hive-112019"],"app":"peakd/2023.11.3"}
created2023-12-09 21:01:27
last_update2023-12-09 21:01:27
depth2
children1
last_payout2023-12-16 21:01:27
cashout_time1969-12-31 23:59:59
total_payout_value0.000 HBD
curator_payout_value0.000 HBD
pending_payout_value0.000 HBD
promoted0.000 HBD
body_length112
author_reputation345,191,366,639,512
root_title"SPK Testnet Node Setup Guide"
beneficiaries[]
max_accepted_payout1,000,000.000 HBD
percent_hbd10,000
post_id129,542,478
net_rshares0
@rishi556 ·
Why not do it in the example? Caddy supports v6 out the box.
properties (22)
authorrishi556
permlinkre-disregardfiat-2023129t151639127z
categoryhive-112019
json_metadata{"type":"comment","tags":["hive-112019"],"app":"ecency/3.0.44-mobile","format":"markdown+html"}
created2023-12-09 21:16:39
last_update2023-12-09 21:16:39
depth3
children0
last_payout2023-12-16 21:16:39
cashout_time1969-12-31 23:59:59
total_payout_value0.000 HBD
curator_payout_value0.000 HBD
pending_payout_value0.000 HBD
promoted0.000 HBD
body_length60
author_reputation132,739,675,638,017
root_title"SPK Testnet Node Setup Guide"
beneficiaries[]
max_accepted_payout1,000,000.000 HBD
percent_hbd10,000
post_id129,542,821
net_rshares0
@rishi556 ·
Whats the minimum and recommended specs to get this up and running?
properties (22)
authorrishi556
permlinkre-spknetwork-s5f7na
categoryhive-112019
json_metadata{"tags":["hive-112019"],"app":"peakd/2023.11.3"}
created2023-12-09 22:25:57
last_update2023-12-09 22:25:57
depth1
children1
last_payout2023-12-16 22:25:57
cashout_time1969-12-31 23:59:59
total_payout_value0.000 HBD
curator_payout_value0.000 HBD
pending_payout_value0.000 HBD
promoted0.000 HBD
body_length67
author_reputation132,739,675,638,017
root_title"SPK Testnet Node Setup Guide"
beneficiaries[]
max_accepted_payout1,000,000.000 HBD
percent_hbd10,000
post_id129,544,647
net_rshares0
@spknetwork ·
IPFS can run in browser, and the only thing most of the rest of this does besides talking is hashing. It should run just about anywhere that has half a gig of ram and a cpu. Of course the thing we're trying to share is the hard drive space, and for full setups you'll need a little more buffer room to manage file uploads. 

We're very interested to see what the lower requirements are.
properties (22)
authorspknetwork
permlinkre-rishi556-s5i91b
categoryhive-112019
json_metadata{"tags":["hive-112019"],"app":"peakd/2023.11.3"}
created2023-12-11 13:48:48
last_update2023-12-11 13:48:48
depth2
children0
last_payout2023-12-18 13:48:48
cashout_time1969-12-31 23:59:59
total_payout_value0.000 HBD
curator_payout_value0.000 HBD
pending_payout_value0.000 HBD
promoted0.000 HBD
body_length386
author_reputation348,970,601,774,222
root_title"SPK Testnet Node Setup Guide"
beneficiaries[]
max_accepted_payout1,000,000.000 HBD
percent_hbd10,000
post_id129,584,968
net_rshares0
@robsteady ·
It looks like I've got a test node up and running in Docker, but I'm not showing any LARYNX after following/unfollowing a couple of times. Does a contract need to be written for my storage to be available on the network? My dashboard is reporting a percentage used with 1 object.
properties (22)
authorrobsteady
permlinkre-spknetwork-sag5gi
categoryhive-112019
json_metadata{"tags":["hive-112019"],"app":"peakd/2024.3.3"}
created2024-03-16 15:24:18
last_update2024-03-16 15:24:18
depth1
children0
last_payout2024-03-23 15:24:18
cashout_time1969-12-31 23:59:59
total_payout_value0.000 HBD
curator_payout_value0.000 HBD
pending_payout_value0.000 HBD
promoted0.000 HBD
body_length279
author_reputation14,889,616,740,776
root_title"SPK Testnet Node Setup Guide"
beneficiaries[]
max_accepted_payout1,000,000.000 HBD
percent_hbd10,000
post_id132,097,426
net_rshares0
@zpek ·
I don't even remember where I've put my Lrn tokens, I shall look for them. I hope they weren't in an order and sold already...
properties (22)
authorzpek
permlinkre-spknetwork-20231210t6142839z
categoryhive-112019
json_metadata{"tags":["spknetwork","proofofacces","poa","hive","web3","blockchain","leofinance","ctp","testnet","spk"],"app":"ecency/3.0.37-vision","format":"markdown+html"}
created2023-12-10 04:01:45
last_update2023-12-10 04:01:45
depth1
children0
last_payout2023-12-17 04:01:45
cashout_time1969-12-31 23:59:59
total_payout_value0.000 HBD
curator_payout_value0.000 HBD
pending_payout_value0.000 HBD
promoted0.000 HBD
body_length126
author_reputation11,394,722,473,537
root_title"SPK Testnet Node Setup Guide"
beneficiaries[]
max_accepted_payout1,000,000.000 HBD
percent_hbd10,000
post_id129,549,239
net_rshares0