> For the complete documentation index, see [llms.txt](https://zel.gitbook.io/zelnodes/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zel.gitbook.io/zelnodes/beginner-zelcore-zelnode-setup-guide.md). # Beginner ZelCore ZelNode Setup Guide ## Up-to-date as of 15Mar2019 | Uses 'ZelNodeInstallv3' script ![](https://camo.githubusercontent.com/c42eceb1d5ca63af489c9ff418b2a02fe9261b22/68747470733a2f2f696d6775722e636f6d2f7451516b4d506e2e706e672f3836302f333135) **This guide will assist you in setting up a ZelNode on a DigitalOcean VPS running Ubuntu 18.04.5 x 64** **Use Goose's video guide in conjection with these steps to help answer any questions by clicking** [**here**](https://www.youtube.com/watch?v=NNWgBzEl_TI) **If you require further assistance contact the support team on** [**Discord**](https://discord.gg/szN9yZ) **or** [**Telegram English**](http://t.me/zelcash) **/** [**Chinese**](http://t.me/zelcashcn) **/** [**Russian**](http://t.me/zelcashru) ### Requirements 1. **ZEL Collateral (10K Basic / 25K Super / 100K BAMF)** 2. **Controller wallet (ZelCore or ZelCash Swing Wallet)** 3. **VPS running Linux Ubuntu 18.04 (benchmark requirements can't be guranteed for servers that the team hasn't tested)** 4. **SSH client such as** [**Putty**](https://www.putty.org/) ### Contents * **Section A : Preparing ZelCore Wallet** * **Section B : Creating** [**DigitalOCean**](https://www.digitalocean.com/) **VPS** * **Section C : Downloading and Installing** [**Putty**](https://www.putty.org/) * **Section D : Connecting VPS and Installing ZelNode Script** * **Section E : Connecting and Starting ZelNode** ### Section A: Preparing ZelCore Wallet ***Step 1 (if necessary)*** * **Download the current ZelCore wallet based on your OS by clicking** [**here**](https://zelcore.io/#download) ![Example-OS](https://camo.githubusercontent.com/add0ccd65afd21a9bcdf3900db66044462373527/68747470733a2f2f696d6775722e636f6d2f7531635a5164392e706e67) ***Step 2 (if necessary)*** * **Download bootstrap file to drastically decrease sync time by clicking** [**here**](https://github.com/zelcash/zelcash/wiki/Bootstrap-for-ZelNodes) ***Step 3*** * **Open your ZelCore wallet and choose 'ZelCash' (Click 'My Assets' and add 'ZelCash' if not already displayed in 'Portfolio' screen)** ![Example-OS](https://camo.githubusercontent.com/eff15fb2a200b39b97d44504573fc9fbedda42f4/68747470733a2f2f696d6775722e636f6d2f39577272754a522e706e67) ***Step 4*** * **'Full Node'** ![Example-OS](https://camo.githubusercontent.com/3fb0daa391ff03b1312b31ddf0530654100dbb05/68747470733a2f2f696d6775722e636f6d2f43584c4c4574682e706e67) ***Step 5*** * **'Launch Full Node'** ![Example-OS](https://camo.githubusercontent.com/3f6ca4f7a486464bc14cdd8bef7cbaa6aa58c898/68747470733a2f2f696d6775722e636f6d2f4576456a3648322e706e67) ***Step 6*** * **'Launch ZelCash' when prompted** ![Example-OS](https://camo.githubusercontent.com/f9dcc713278f009bc71ee9389fe471e95bd0d0e0/68747470733a2f2f696d6775722e636f6d2f506249494574392e706e67) ***Step 7*** * **Go into 'Tools' after wallet is 100% synced** ![Example-OS](https://camo.githubusercontent.com/d3e7a4efb39b3d3f0cfb789367a0463dcb907884/68747470733a2f2f696d6775722e636f6d2f7576716a565a362e706e67) ***Step 8*** * **Open ZelNodes Management** ![Example-OS](https://camo.githubusercontent.com/b6270faad0359a6e5a0306e2b6e4e38211e2902b/68747470733a2f2f696d6775722e636f6d2f417056773441552e706e67) ***Step 9*** * **Setup ZelNodes** ![Example-OS](https://camo.githubusercontent.com/891aa4efe361676482e77aa0e1f6863cfd6e2ac7/68747470733a2f2f696d6775722e636f6d2f65475a6c7252432e706e67) ***Step 10*** * **'Backup all addresses' (use a text file to save info, and store in multiple secure locations)** ![Example-OS](https://camo.githubusercontent.com/04622dd207bfcf461d02febaff1e86f7112faf22/68747470733a2f2f696d6775722e636f6d2f78645159474f502e706e67) ***Step 11*** * **Set automatic logout to 'Never'** ![Example-OS](https://camo.githubusercontent.com/03f58a8e7c1a53a3457098a9501d53eb25384465/68747470733a2f2f696d6775722e636f6d2f67386e694830652e706e67) ***Step 12*** * **Continue to the next step after zelcash.conf info is generated** ![Example-OS](https://camo.githubusercontent.com/d984a7a7148ed974495a90f48a0d00c98a3a59fb/68747470733a2f2f696d6775722e636f6d2f5254667362524d2e706e67) ***Step 13*** * **Choose which type of ZelNode you are going to set up** ![Example-OS](https://camo.githubusercontent.com/5d19f76ad6ed469aedb2b4db2bb5d12c687da155/68747470733a2f2f696d6775722e636f6d2f513361344d50562e706e67) ***Proceed to the next section, leave ZelCore wallet open to continue setting up in future steps*** ### Section B: Creating DigitalOcean VPS ***Step 1*** * **Register at** [**DigitalOcean**](https://m.do.co/c/c9c22684c5db) **(use this** [**referral link**](https://m.do.co/c/c9c22684c5db) **to receive a $100 credit that's good for 2 months)** ***Step 2*** * **After you have your account setup go** [**here**](https://cloud.digitalocean.com/droplets?i=8fe2ca\&preserveScrollPosition=false) **to create your ZelNode droplet** ![Example-OS](https://camo.githubusercontent.com/084930cd02ebb29147e4d4039ce9c00e50c06782/68747470733a2f2f696d6775722e636f6d2f5759466443316a2e706e67) ***Step 3*** * **Choose server type: 'Ubuntu 18.04'** ![Example-OS](https://camo.githubusercontent.com/e69b218d0a3b820ae4402905a9208894bde98dbb/68747470733a2f2f696d6775722e636f6d2f34684d397567552e706e67) ***Step 4*** * **Choose Droplet (Basic/Super/BAMF)** ![Example-OS](https://camo.githubusercontent.com/fa052f36d06c74bf9879c5d4c13b9a867b74c5c3/68747470733a2f2f696d6775722e636f6d2f73566161777a742e706e67) ![Example-OS](https://camo.githubusercontent.com/584b8e50012fb46e8a9736c0d7bfaf019fdae9c9/68747470733a2f2f696d6775722e636f6d2f316841755432542e706e67) ![Example-OS](https://camo.githubusercontent.com/f8e8ae6974a475fd7e0c9a757cb6932bd9a6140e/68747470733a2f2f696d6775722e636f6d2f596333576d37712e706e67) ***Step 5*** ![Example-Location](https://camo.githubusercontent.com/8a7a012c8cf1dc977872e75b5382e51d9e5f2f4b/68747470733a2f2f696d6775722e636f6d2f686a6d5a6961662e706e67) **(Consider choosing a data center not near you to help decentralize the network. The location of the data center does not affect your rewards or setup process.)** ***Step 6*** ![Example-OS](https://camo.githubusercontent.com/41f00da994b51f4129b8bd7d23fdc8a28b5a44da/68747470733a2f2f696d6775722e636f6d2f716c594453566e2e706e67) ### Section C: Downloading and Installing Putty ***Step 1*** * **Download Putty** [**here**](https://www.putty.org/) ***Step 2*** * *Select the correct installer depending upon your operating system, and follow the install instructions*\* ![Example-Putty Installer](https://camo.githubusercontent.com/49ad44c6d7a804c4adfc395a3735dbf073c747b7/68747470733a2f2f696d6775722e636f6d2f553765614e53682e706e67) ### Section D: Connecting VPS and Installing ZelNode Script ***Step 1*** * **Copy your VPS IP (located within Droplets tab)** ![Example-DO](https://camo.githubusercontent.com/dd9ae0f18609b00271001e027ce02326bee1dc5c/68747470733a2f2f696d6775722e636f6d2f3859574d4e78572e706e67) ***Step 2*** * **Open the Putty terminal and fill in the "Host Name" box with the IP address of your VPS** ![Example-PuttyLogin](https://camo.githubusercontent.com/8a97dca874094093e87a863b06b6df2269b6a513/68747470733a2f2f696d6775722e636f6d2f674d6b643666732e706e67) ***Step 3*** * **Once you hit 'Open' a security alert will open up (click yes)** ![Example-RootPassEnter](https://camo.githubusercontent.com/b4701ff90d2780a4fa28940c3980fb82a867f24c/68747470733a2f2f696d6775722e636f6d2f7a304e32414d542e706e67) ***Step 4*** * **Type "root" as the login/username** ![Example-Root](https://camo.githubusercontent.com/04961f54dcd3bbd7802476b46991c5ab12be5178/68747470733a2f2f696d6775722e636f6d2f44756d51564a352e706e67) ***Step 5*** * **Copy the root password that DigitalOcean emailed you** ***Step 6*** * **Paste the password into the Putty terminal by right clicking (it will not show the password so just press enter)** ![Example-RootPassEnter](https://camo.githubusercontent.com/72d1917a59134893d85a4e045b5dc07d55f2e16f/68747470733a2f2f696d6775722e636f6d2f547165485632432e706e67) ***Step 7*** * **Enter password for root (UNIX password same as Step 5)** * **Make new password and confirm** ![Example-RootPassEnter](https://camo.githubusercontent.com/a5743796f97699fedccc3d1c79d170cf8def9c17/68747470733a2f2f696d6775722e636f6d2f765358746161472e706e67) ***Step 8*** * **Update VPS with the following 2 commands** `sudo apt-get update` `sudo apt-get upgrade -y` ***Step 9*** * **Adduser to secure your VPS, by adding a new username so you aren't running everything as root** * **Run the command below and use a username that you want associated with this server ('whodatbamf1' is an example, you need to generate your own username)** `adduser YOURUSERNAME` ![Example-Bash](https://camo.githubusercontent.com/851438a47656322008df07a70d71fd6ac64de4ab/68747470733a2f2f696d6775722e636f6d2f484a77623874542e706e67) ***Step 10*** * **You will then need to make a new password associated with your new username. Hit 'Enter' for the next 5 lines after your new password has been set, then 'Y' to save your information.** ![Example-Bash](https://camo.githubusercontent.com/d5d231e76973187379a31105d4f2da1a3d35ab69/68747470733a2f2f696d6775722e636f6d2f737566304439592e706e67) ***Step 11*** * **Grant sudo permissions for your adduser by running the command below to activate it** `usermod -aG sudo YOURUSERNAME` ***Step 12*** * **Reboot server with the following command** `sudo reboot -n` * **Close Putty terminal while server reboots** ### Section E : Connecting and Starting ZelNode (ZelCore and VPS) ***Step 1 (ZelCore)*** * **Go back to your ZelCore wallet and enter your VPS IP address** ![Example-installing](https://camo.githubusercontent.com/a4e9fe685b58e8eefa4cee3ab02d333866b56679/68747470733a2f2f696d6775722e636f6d2f615076674b49302e706e67) ***Step 2 (ZelCore)*** * **Name your ZelNode** ![Example-installing](https://camo.githubusercontent.com/2078de61450099181e2fe250e8774bc0bb6958f8/68747470733a2f2f696d6775722e636f6d2f5973705469344a2e706e67) ***Step 3 (ZelCore)*** * **Save your private key that is generated in ZelCore and enter on VPS when prompted** ![Example-installing](https://camo.githubusercontent.com/a50bc586fcfea72dd723cb38d217dda257085712/68747470733a2f2f696d6775722e636f6d2f49743746516a572e706e67) ***Step 4 (VPS)*** * **Log back into your VPS with the new username and password from Section D: Steps 9 and 10** ***DO NOT RUN THE INSTALL SCRIPT AS ROOT, ONLY RUN IT AS THE NEW USER THAT WAS MADE IN STEP 9!!!!!!!!!!!!!!!*** ***Step 5 (VPS)*** * **Paste the code below into the Putty terminal then press enter** `wget -O zelnode.sh https://raw.githubusercontent.com/zelcash/ZelNodeInstallv3/master/zelnodev3.sh && chmod +x zelnode.sh && ./zelnode.sh` ***HUGE SHOUTOUT TO GOOSE, SKYSLAYER AND DK808 FOR PUTTING TOGETHER THIS INSTALL SCRIPT*** ***Step 6 (VPS)*** * **Confirm IP and enter private key from Step 3** ![Example-installing](https://camo.githubusercontent.com/5c9bc3f5c6fc5fbb3bbb1450015a722f136ff9ea/68747470733a2f2f692e696d6775722e636f6d2f54464d503431622e6a70672e706e67) ***Step 7*** * **Go to the ZelCash block explorer** `https://explorer.zel.cash/` ![Example-installing](https://camo.githubusercontent.com/a4e162564114ad41ff561d37139a4fbc9365c16f/68747470733a2f2f696d6775722e636f6d2f6c69424e46354f2e706e67) ***Step 8 (VPS)*** * **Press any key, then CTRL-C when the blocks match explorer in Step 6** ![Example-installing](https://camo.githubusercontent.com/f941101938ccce4801b020748fd55408bc516437/68747470733a2f2f692e696d6775722e636f6d2f34364834594a6e2e6a70672e706e67) ![Example-installing](https://camo.githubusercontent.com/fa21b40fef74480c26fb2021a78ba84b31c5d007/68747470733a2f2f696d6775722e636f6d2f437144314b71612e706e67) ***Step 9 (ZelCore)*** * **Activate your ZelNode** ![Example-installing](https://camo.githubusercontent.com/e7b7380432e1e862210fb5f55e926959d092eb3f/68747470733a2f2f696d6775722e636f6d2f7879506d6f66522e706e67) * **Successfully started will show if everything is done properly ('startzelnode local false' isn't needed)** ![Example-installing](https://camo.githubusercontent.com/f0790b8b661b368fa71207620687f1ec69669bd6/68747470733a2f2f696d6775722e636f6d2f474770637946412e706e67) ***(It will take 15 confirmations for your ZelNode to show up in 'MY ZELNODES')*** ***Step 10*** * **Run the following command in VPS to confirm that your ZelNode is showing 'Status 4' (If VPS does not show successfully started, wait 5 minutes and run the command again. Repeat if necesary)** `sudo zelcash-cli getzelnodestatus` ![Example-installing](https://camo.githubusercontent.com/608a6b9fa5a46e7da6e2a708e90fa13f77210c2b/68747470733a2f2f696d6775722e636f6d2f6e6a37364a37442e706e67) * **You can also view your ZelNode on the block explorer `https://explorer.zel.cash/zelnodes`** ![Example-installing](https://camo.githubusercontent.com/06106acdc2498ed8171b6b2eef4cdc6f3fcce1a9/68747470733a2f2f696d6775722e636f6d2f536b47716136442e706e67) **(It will show up as 'PRE\_ENABLED' prior to 15 confirmations)** ***CONGRATULATIONS AND THANK YOU FOR BEING A PART OF THE COMMUNITY!!!!!!!!!!!!!***