Mac OS & Linux

How to Setup a Darknode via Digital Ocean (DO) | Chaosnet Instructions

How to Setup a Chaosnet Darknode via Digital Ocean (DO) on Mac OS & Linux

Step 1: Destroy old Darknode(s)

1. If you have any previously deployed Darknodes; deregister, refund and destroy them.

2. After that, delete the entire .darknode backup folder on your computer.

3. Delete the API token via https://cloud.digitalocean.com/account/api that correspond to the old Darknode.

*The new Chaosnet CLI is not backwards compatible with old darknodes, so if trying to managing old backup with new darknode-cli, it’s not going to work. The old Darknode CLI (version 2.2.11 release) must be used to deregister old Darknodes. You must not upgrade your CLI until you have done this.

Step 2: Starting Fresh | Create a Digital Ocean Account and API Token

1. If you don't have one already, create an account on Digital Ocean | https://www.digitalocean.com

2. Enter your personal and payment information

3. Once completed it will bring you to the DO ‘mainhub’

   1. Click 'API' on the left-hand side menu

   2. Click ‘Generate New Token’

      1. If needed, follow the official DO Instructions for more detail: https://www.digitalocean.com/docs/api/create-personal-access-token/

   3. Save your API Token Address in a secure location! Make sure you keep these values secure, anyone with access to them will be able to control your Darknode.

   4. Move to the next step below

Step 3: Install the Darknode CLI on Your Computer

1. Open your Mac Terminal

   1. Open your terminal by searching for 'Terminal' in the 'Launchpad' app

   2. Click the app to open the Terminal

   3. Insert this text to install the CLI, by pasting: curl https://www.github.com/renproject/darknode-cli/releases/latest/download/install.sh -sSfL | sh

2. It will take a minute. Once successfully installed, you'll see some green text.

3. Now, close the Terminal app and re-open.

4. If everything goes well, you should see v3.0.2 when you run darknode -v command.

Step 4: Deploy your Darknode

1. Open the Terminal app on your computer

   1. Then copy and paste the following: darknode up --name MY-FIRST-DARKNODE --do --do-token YOUR-API-TOKEN

2. Replace MY-FIRST-DARKNODE and YOUR-API-TOKEN by

   1. Input a name for your Darknode but make sure it has no spaces in it or is not too long.

   2. Input your Digital Ocean API Token found in step 2

Example of what this would look like: darknode up --name darknodeone --do --do-token 1111aca25cc77d84299e3b8a0f76f2ec33a27b1782adc2a7a96f0468116edf46

1. Press enter and wait approximately 3-5 minutes while your Darknode is installed.

   1. Don’t touch anything, let the CLI works its magic and wait patiently!

   2. When completed, the CC should open automatically in your browser but you will also be provided a link (in green) within the terminal. If it doesn't open automatically in your browser, copy and paste (the relatively long green link) it into the web-browser. Either way it will take you to the new Command Center!

Step 5: Register and launch your Darknode on the Command Center (CC)

1. Bookmark your CC Webpage!

2. Before proceeding, make sure you have 10,000K REN in your MetaMask wallet along with at least .1 ETH (recommended amount) for your Darknode's GAS.

   1. Please be aware you must register using the CC with MetaMask. You can use Hardware wallets via MetaMask but we have seen issues in the past with drivers updates, etc.. so proceed with caution and make sure your contract data setting is turned on.

   Note: One cannot just send REN to your Darknode because this will not cause it to be registered.

3. Sign into MetaMask as you normally would and ensure the above REN and ETH are in your account.

4. Register your Darknode

   1. Click the ‘REGISTER YOUR DARKNODE’ button (top left) in the CC.

      1. At this point, the CC will indicate the profitability of running a Darknode (via pop-up notification), and you will be notified if it’s unprofitable.

      2. If you choose to proceed, follow the below steps.

   2. Submit your 10K Ren via MetaMask instructions, sign transactions, etc.

   3. Wait a few minutes while your Darknode registers, sign the needed MetaMask transactions for GAS, etc.

   4. Once completed, you will be notified that your ‘Registration is in Progress’

   5. Wait patiently for your Darknode to be fully registered (can take up to 8 days)

   6. In the meantime, top-up your Darknode up with GAS via the ‘GAS BALANCE’ section

      1. Click the arrow ‘>’ and submit .1 ETH (recommended amount) for GAS.

   7. The CC will not function fully until the Darknode has been fully registered, so don't be alarmed if you explore the CC and buttons don't function properly. Just wait to explore until your registration is complete.

5. Once you've added ETH to your Darknode, wait patiently, but in the interim:

   1. Back up your Darknode file on MAC OS but inputting this into your Terminal and pressing enter: cp -r ~/.darknode ~/Desktop/darknode-backup-2019XXXX (i.e XXXX = A date of your choice).

   2. A backup folder will then appear on your Desktop, save this somewhere safe!

6. After the 8 day waiting period, check back on the CC.

Review the NETWORK INFORMATION tab on the right-hand side of the CC for details. The CC should also note that you Darknode is 'Registered' on the top-left. Step 6: Congrats, you're all done and remember to periodically check on your Darknode and refill it with ETH as needed. Welcome to Chaosnet!