The Darknode CLI is not backwards compatible with old Darknodes, so if you have ran an old darknode (Chaosnet or otherwise), you need to start fresh! Trying to managing old backups with the new darknode-cli, it’s not going to work. The old Darknode CLI must be used to deregister old Darknodes, therefore you must completely deregister old Darknode first. You cannot upgrade your CLI until you have done this.
*If this is your first time running a Darknode start at Step 2.
If you have any previously deployed Darknodes; deregister, refund and destroy by following these instructions.
After this has been fully completed, delete the entire .darknode backup folder on your computer. It is no longer relevant if you have completed the above steps.
Confirm the API token that correspond to the old Darknode has been deleted via your VPS account.
If you don't have one already, create an account on Digital Ocean | https://www.digitalocean.com
Enter your personal and payment information
Once completed it will bring you to the DO ‘mainhub’
Click 'API' on the bottom left-hand side menu
Click ‘Generate New Token’, with default settings, both write and read checked.
If needed, follow the official DO Instructions for more detail: https://www.digitalocean.com/docs/api/create-personal-access-token/
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.
Move to the next step below
Follow the below instructions:
Click Start and type Powershell. Right-click and launch Windows PowerShell as an administrator. Run this command: dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
This will activate "Windows Subsystem for Linux" optional feature. After this, restart your computer.
Once restarted, open Microsoft Store and search for Ubuntu 18.04 LTS. Click on it and from the distribution's page, select "Get".
Open up Ubuntu app on Desktop once installed and then you will be asked to:
Launch Ubuntu and create a user account and password for your new Linux distribution but clicking this link.
Close terminal and proceed below
Open your Ubuntu terminal
Input password you created above in step Step 3.5.1
Insert this text to install the CLI, by pasting:
curl https://www.github.com/renproject/darknode-cli/releases/latest/download/install.sh -sSfL | sh
Wait a minute or two. Once successfully installed, you'll see some green text.
Close and then re-open the Terminal app on your computer
If everything goes well, you should see 3.0.14 when you run
darknode --version
command.
Then copy and paste the following:
darknode up --name MY-FIRST-DARKNODE --do --do-token YOUR-API-TOKEN
Replace ‘MY-FIRST-DARKNODE’ and ‘YOUR-API-TOKEN’ by
Input a name for your Darknode but make sure it has no spaces in it or is not too long.
Input your Digital Ocean API Token found in step 2 *Example of what this would look like: darknode up --name darknodesteve --do --do-token 1111aca25cc77d84299e3b8a0f76f2ec33a27b1782adc2a7a96f0468116edf46
Press enter and wait approximately 3-5 minutes while your Darknode is installed.
Don’t touch anything, let the CLI works its magic and wait patiently!
When completed, you will be provided a link (in green) within the terminal.
If a webpage does not open automatically, please copy and paste the (relatively long green) link into the web-browser, which will take you to the new Command Center!
Some tips to keep in mind
If you see "Register Darknode (Public Key Required)". Copy/paste the link directly from Ubuntu, input that into your web browser and all should work well.
Turn off all ad blockers (and "shields" if using Brave).
If using a Ledger via MetaMask, make sure your “Contract Data” is turned on.
Sign into MetaMask and then bookmark your CC Webpage!
Before proceeding, make sure you have 100K REN in your MetaMask wallet along with 0.1 ETH (recommended amount) for your Darknode's GAS.
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.
Sign into MetaMask as you normally would and ensure the above REN and ETH are in your account.
Register your Darknode
Click the ‘REGISTER YOUR DARKNODE’ button (top left) in the CC.
Submit your 100K Ren via MetaMask instructions, sign transactions, etc.
Wait a few minutes while your Darknode registers, sign the needed MetaMask transactions for GAS, etc.
Once completed, you will be notified that your ‘Registration is in Progress’
Wait patiently for your Darknode to be fully registered (can take up to 31 days)
In the meantime, top-up your Darknode up with GAS via the ‘GAS BALANCE’ section
Click the arrow ‘>’ and submit 0.1 ETH (recommended amount) for GAS.
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.
Once you've added ETH to your Darknode, wait patiently, but in the interim:
Back up your Darknode file but inputting this into your Terminal and pressing enter (Windows OS via Ubuntu):
cp -r .darknode/ /mnt/c/Users/Administrator/Desktop/2020xxxx
(Note: Replace ‘Administrator’ with their windows username). A backup folder will appear on your desktop/documents folder. Save this folder somewhere safe!
A backup folder will then appear on your Desktop, save this somewhere safe!
After the 31 day waiting period, check back on the CC and click the registration button.
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 left.