Allen Dixon
Mar 21 · 6 min read

For more advanced users that would like to launch a NKN Full Node on AWS using a pre-existing NKN wallet, please follow the steps below. If you do not already have a wallet, you can create a wallet using the official NKN wallet.

To create a NKN Full Node with a Pre-existing wallet:

1. From the AWS Management Console, Click on the link “Launch a Virtual Machine from EC2”.

2. Set the region you would like to launch your NKN Full Node by going to the upper right hand corner of the console window and clicking on the region (2nd option from the right) and selecting the desired region from the drop down menu (example: US West (Oregon))

3. On the next page choose “AWS Marketplace” from the menu on the left hand side of the page and in the search bar type “NKN” and press enter to search the marketplace. Click the “Select” button next to the NKN entry. Review the resulting pop-up window for details on the NKN Full Node and click “Continue”

4. On the next page you can choose an instance type. Choose the “t2.micro” instance and click on the “Next: Configure Instance Details” in the lower right hand corner

5. From the Configure Instance Details Page, scroll to the bottom and click on “Advanced Details” to expand the menu. You should see a parameter called User Data and a text box next to it that reads ‘optional’. Above the text box, choose “As text” and in the box paste the contents below:

- owner: nkn:nkn
path: /home/nkn/go/src/
content: |
- cd /home/nkn/go/src/
- sudo jq -n --argfile c1 config.json --argfile c2 config.user.json '$c1 + $c2' > /tmp/config.json.merged
- sudo mv /tmp/config.json.merged config.json
- sudo chown nkn:nkn config.json

Replace YOUR_EXISTING_NKN_WALLET_ADDRESS in the text above with your NKN wallet address, a string starting with the letter N (example: NcLrZVhaDdudT25GTr6EeLyGiy8g1VHdTs).

When Complete click “Next: Add Storage” in the lower right hand corner.

6. From the Add Storage Page, choose 25GB and click “Review and Launch” in the lower right hand corner.

7. Review your settings and when ready click Launch. After you click launch, a pop up window will ask to choose a key pair. Either choose an existing pair or create a new key pair.

NOTE: You can use the key pair to help login to the instance later if needed. See for more information.

To create a key pair, choose “Create a new key pair” from the drop down menu, choose a name for your new key pair and click the button “Download Key Pair”.

For Apple Safari Users: The resulting file will initially come with .pem.txt extension, you can remove the .txt so it will end with a .pem extension. Y

For Google Chrome Users: The file downloaded with have the correct .pem extension.

You also need to change the attributes of the key file using the following command: chmod 400 KEY_PAIR_FILE

Example: chmod 400 nkn_node_keypair.pem

Click “Launch Instances”.

After Launch

After the instance is created, nknd (NKN daemon) will be launched automatically by supervisor under user nkn, and your instance will join the NKN relay network without any further configurations.

Once the node has been started you can check the status using any of these methods:

* Use community built webtool nknX — You just need the public IP address of your VM in order to check its status.

* Command line tool nknc from a remote computer. You can download the latest nknc release and use the command ./nknc — ip info -s to view the status of your node.

* Command line tool nknc from within the VM. The tool nknc is already installed and located in the directory /home/nkn/go/src/ You can use the command ./nknc info -s to view the status of your node. For additional commands, type ./nknc — help

If you did not configure a pre-existing wallet prior to launching the instance, a NKN wallet and its password will be generated automatically when the node is started the first time. Two files will be created under the directory /home/nkn/go/src/ named wallet.json and wallet.pswd respectively. Please take care to protect and back up both of these files since they are needed to access and control your account.

Backup NKN Wallet

In order to backup your wallet.json and wallet.pswd files, you need to use the following steps:

1.) Using your chosen key pair, login to the NKN Full Node instance you have created on AWS. From your favorite terminal (PuTTy, OSX terminal, etc.) run the following command: ssh -i KEY_PAIR_FILE ubuntu@AWS_VM_PUBLIC_ADDRESS

KEY_PAIR_FILE is the key pair file downloaded when you created your key pair on AWS. If you uploaded your ssh’s default pubkey (e.g. ~/.ssh/, you can ignore the -i argument and simply use ssh ubuntu@AWS_VM_PUBLIC_ADDRESS

AWS_VM_PUBLIC_ADDRESS is the public address of the VM running NKN Full Node, which you can find from your EC2 console.

Example: ssh -i nkn_node_keypair.pem ubuntu@ec2–1–2–3–

2.) Once you are logged in as ubuntu, change directory to the nkn directory where wallet.json and wallet.pswd files are located:

cd /home/nkn/go/src/

3.) Copy and paste the contents of wallet.json and wallet.pswd files to a txt file on your local computer as backup using the following commands:

sudo cat wallet.jsonsudo cat wallet.pswd


ubuntu@ip-172–31–6–239:/home/nkn/go/src/$ sudo cat wallet.json{“PasswordHash”:”473cf1faffbfbca01f23ca81f8a6b22c977088121cbe243755aa53fb26780e24",”IV”:”0953e70e6acebec746ac6321a52efb87",”MasterKey”:”08695141d3ea038abf62be56025e4021128048fdbc589fe956ad8f07b939305b”,”Version”:”0.0.1",”Address”:”NVCCNDETCtf6N3s4L94FtfJoNYJJmxFZtx”,”ProgramHash”:”65caca2efbcc9e820e63fc8745425ac4f22c5e92",”PrivateKeyEncrypted”:”ff5387b1ba322275123b7479c43449ff24b3e86bca5359a0dbbe472a1b3e422e”,”ContractData”:”232102d8a0488e21064b49a8bf67f4c2c0cad67f8e84c3f6c9295e38177437fbd3932fac010065caca2efbcc9e820e63fc8745425ac4f22c5e92"}ubuntu@ip-172–31–6–239:/home/nkn/go/src/$ubuntu@ip-172–31–6–239:/home/nkn/go/src/$ sudo cat wallet.pswdfqRTYLValQeYDZpz/HubONc3ipi2sE53

Using your favorite text editor, copy the entire contents of wallet.json starting from and including the open bracket “{“ to the closed bracket “}” to a txt file called wallet.json. You might need to remove unnecessary line breaks between lines, so everything is one continuous paragraph.

Next copy the entire contents of wallet.pswd to a text file called wallet.pswd on your local machine.

To test if they are correct, please use to open backed-up wallet.json and password. You now have backed up both wallet.json and wallet.pswd from your NKN Full Node!.

Next Steps

For more information on NKN Full Node, please visit our Github. You can use the NKN network to transmit any data from peer to peer using nkn-client-js or other NKN client implementations. You can also transfer NKN tokens using either the NKN Official Wallet or nknx.

Please join the NKN Discord group or visit the NKN Forum for more technical support and discussions.


NKN (New Kind of Network) - Network Infra for Decentralized Internet

Allen Dixon

Written by

Innovator with a passion for integrating technology and business to create new opportunities and new solutions.



NKN (New Kind of Network) - Network Infra for Decentralized Internet

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade