Linux / VPS Wallet 1.1.1 Setup Guide

conquistad0r
2018-09-19 19:29

ColossusXT Linux / VPS Wallet 1.1.1 Setup Guide

 

Security Advisory

Please use common sense and security best practices when working with other people to help configure and troubleshoot your wallet!

Scammers often pose as team members or "tech support". All official ColossusXT team members have custom colored names in the ColossusXT Discord.

Never share your keys, passwords, or wallet files with anyone. Never install third-party software or allow people to remotely control or view your system.

Remember, where there is money there are thieves!

 

Before we begin, if you’re new to Linux, it’s recommended that you become familiar with the basic commands. Here is a good cheat sheet to get you started.

 

First, a few quick bits of information you’ll need for this guide:

  1. All Linux commands are CASE SENSITIVE. ALWAYS pay close attention to case.
  2. The ~ symbol is a shortcut to the current user’s home folder, which is /root for the root login, and /home/username for any other user’s login. You will see this very often. It is not a random squiggly mark; it has a specific and important meaning.
  3. Just like on Windows and OSX, the Linux COLX program folder (~/colx-1.1.1) will be different than the COLX wallet folder (~/.ColossusXT). The program folder contains the executable application files, while the wallet folder contains your wallet.dat file and your local copy of the COLX blockchain database.

 

Note: This guide is for a new install. If you are updating from a previous version, please use the Linux / VPS 1.1.1 Update Guide instead. It will be much quicker!

 

Connecting To Linux / VPS

Most VPS services come with a web-based console that lets you connect to your VPS without installing any additional software. However, many users prefer to install third-party software to connect to their VPS remotely.

For Windows, the most common Windows software to connect to a VPS is PuTTY. It is available for download here. Download and run the MSI installer, then run the PuTTY application. Enter the IP of your VPS, select port 22 and SSH, and click Open. You can also optionally click Save on this screen so that your Putty application will automatically open with these settings in the future.

The first time you connect with Putty, you will receive a Security Alert. Click Yes to this alert to continue to a login prompt.

Enter the your login credentials to log in. No characters will be displayed while you enter your password.

PuTTY Usage Note: To copy-paste into the PuTTY window, copy the text you wish to paste, then right-click in the PuTTY window. The text will be pasted at the location of your text cursor.

For OSX, a Terminal application is already built in and there is no need to install additional software like PuTTY. On OSX, Search for the “Terminal” application in Spotlight search or your applications menu. Use the ssh command along with your username and IP address to log in to your system:

ssh username@123.234.123.234

You will see a similar one-time security warning. Type “yes” to continue:

For Linux, use the above ssh command to connect from your Linux terminal

 

Linux / VPS Password Security

Use a long, strong, and unique password. Your password should be at least 20 characters. Your password should not be in any dictionary. It should contain uppercase and lowercase letters, numbers, special characters, etc. Don't use obvious substitutions like 0 for O or 5 for S. Don't use a password that you use anywhere else, or even a password similar to one you use elsewhere.

To change your password, use the passwd command after logging in.

 

Linux / VPS Additional Security Options

Because Linux / VPS systems are generally always online, some users opt to take additional security precautions to protect their system from attacks and intrusion. If you're using your Linux wallet to hold and stake coins, here are some optional security steps you can consider taking to improve the security of your wallet:

Disable root Login: Some users choose to disable SSH login for the default root account, and create a new account for SSH access. Here is a good guide on setting this up.

If you disable root login, you will need to become familiar with the sudo command, which allows you to run commands as root while logged in as another user. You will need to use this for any command that affects the system as a whole and requires root access. For example, when logged in as newuser, you won't need to use sudo to do things like change directories (cd), list files (ls), download files (wget), or launch ColossusXT apps (./colxd). However, to reboot (reboot) or change firewall settings (ufw), you'd need to use sudo reboot or sudo ufw.

This guide is written with the assumption that you are logged in as root.

Install a Firewall: A good option to protect your system from attacks including Denial of Service (DoS) is to install a firewall. The most common one for Linux is Uncomplicated Firewall, or ufw. In fact, depending on which Linux distribution you choose to use, this may already be installed. To check if ufw is installed, type ufw status at the command prompt. If it says "command not found", it's not installed yet.

If ufw isn't installed, use the command apt-get install ufw to install it. Remember, if you disabled root SSH login and are logged in as a different user, you'll need to include the sudo command (sudo apt-get install ufw).

 Once ufw is installed, configure it with the following commands:

ufw allow 51572/tcp  (to open the port used by your server wallet)
ufw allow 51573/tcp  (to open the RPC port used by your server wallet)
ufw allow ssh        (to allow SSH login and prevent locking yourself out!)
ufw enable           (to enable the firewall)

If you're having network connectivity issues and want to check if the firewall is the problem, you can use the command ufw disable to see if that fixes your problem.

For more information, a good starter guide to ufw can be found here.

 

Back Up Wallet

The new wallet program is built to use existing wallet.dat files, however, any time is a good time to back up your wallet! If this is an update from a previous version and not a new installation, back up your wallet file to a secure location before proceeding. The standard location of the wallet file is ~/.ColossusXT/wallet.dat. Copy this to another location, preferably on another machine.

For more details on backing up your wallet.dat, see the section “Backing Up Your New Wallet” near the end of this document.

 

Stop Any Existing COLX Processes

If this is an update rather than a new installation, be sure to stop any existing ColossusXT processes. Navigate to your existing ColossusXT program folder and use this command:

./colx-cli stop

Download The 1.1.1 ColossusXT Wallet Program From Github

Use the wget command to download the 1.1.1 wallet archive directly to your ~/Downloads directory.

NOTE: There are different wallet versions available for each system architecture. If you don’t know your architecture, use the arch command:

Use only the command that matches your system architecture:

x86_64
wget -P ~/Downloads https://github.com/ColossusCoinXT/ColossusCoinXT/releases/download/v1.1.1/colx-1.1.1-x86_64-linux-gnu.tar.gz

i686
wget -P ~/Downloads https://github.com/ColossusCoinXT/ColossusCoinXT/releases/download/v1.1.1/colx-1.1.1-i686-pc-linux-gnu.tar.gz

ARM
wget -P ~/Downloads https://github.com/ColossusCoinXT/ColossusCoinXT/releases/download/v1.1.1/colx-1.1.1-arm-linux-gnueabihf.tar.gz

 

Extract The New Wallet Archive To Your Home Folder

Now use the tar command to extract the archive to a new COLX folder located at /user/home/colx-1.1.1. Again, use only the command that matches your system architecture:

 x86_64
tar xvzf ~/Downloads/colx-1.1.1-x86_64-linux-gnu.tar.gz -C ~

i686
tar xvzf ~/Downloads/colx-1.1.1-i686-pc-linux-gnu.tar.gz -C ~

ARM
tar xvzf ~/Downloads/colx-1.1.1-arm-linux-gnueabihf.tar.gz -C ~

NOTE: If you download and install the wallet for the wrong architecture, you will see an error like this when you attempt to launch the wallet:

 

 

Edit the ColossusXT.conf

 Note: Older versions of the ColossusXT wallet required additional configuration for seed nodes, staking settings, etc. These have all been set as defaults and are no longer necessary.

The only thing that needs to be added to the ColossusXT.conf file is daemon=1. The daemon setting tells the system to start ColossusXT as a background process and return you to the command prompt. If you don’t use the --daemon switch when launching ./colxd and don’t have daemon=1 in your ColossusXT.conf, you will not be returned to the command prompt until you stop the ColossusXT server process by pressing [CTRL]+Z.

There are many text-based text editors for Linux. In this example we’ll use pico. Use this CASE-SENSITIVE command to open your ColossusXT.conf file in the pico editor:

pico ~/.ColossusXT/ColossusXT.conf

This will open your config file in the text editor. Add the following line of text:

daemon=1

When you are done, press [CTRL]+X to exit.

 Press Y at the “Save modified buffer?” prompt:

Then press [Enter] to retain the original filename and exit:

 

The file will be saved, the editor will exit, and you will be returned to the command prompt.

 

Launch The COLX Wallet Application

Use the cd command to navigate to your new ColossusXT program folder and launch the ColossusXT wallet application:

cd ~/colx-1.1.1/bin
./colxd

 The console should now indicate that the server is starting:

 

 Now check the wallet status :

 ./colx-cli getinfo

 

 Check the first line for a version number of 1010100 to verify that you’re now using the 1.1.1 wallet.

Your wallet will now begin to download the COLX blockchain. If you wait a few seconds and repeat the getinfo command, you should see that the number of blocks has increased. You can monitor this number to track your process as the block number increases toward the current block number which can be found at the COLX Blockchain Explorer.

 

Additional Commands For Staking

The colx-cli command is the command line version of the debug console built into the Windows and OSX wallets. Any command you’re familiar with in the GUI debug console will also work here. For example, you can use the getstakingstatus command:

./colx-cli getstakingstatus

 

In this case, staking status is false because there are no mature coins available, the wallet is not yet synchronized, and the wallet is not unlocked for staking.

Before you can stake, you’ll need to encrypt your wallet with the following command:

 ./colx-cli encryptwallet "password"

 

 After encrypting, the wallet application will close. You’ll need to restart it:

 ./colxd

 Just like on Windows and OSX, the wallet application always launches with the wallet locked, so you’ll need to unlock it before you can stake:

 ./colx-cli walletpassphrase "password" 0 true

  

Backing Up Your New Wallet

 After you encrypt your wallet, a new kepool is generated, so you should back it up before sending COLX to any new addresses. The easiest way to back up your wallet.dat from a remote Linux / VPS system is via a secure FTP program such as WinSCP. Install WinSCP from the link provided, then connect using your IP address, login and password. Click “Yes” on the one-time warning to accept the server’s host key.

 Once connected, you will need to press [CTRL]+[ALT]+H to enable viewing hidden files. Navigate to your remote ColossusXT directory (~/.ColossusXT) and drag the wallet.dat to your desired destination on your local file system.

 

Additional Wallet Commands

 The following commands are good to know for standard use of the ColossusXT wallet.

 ./colx-cli getnewaddress “Your New Address Name” to generate a new COLX address in this wallet.
./colx-cli sendtoaddress “address” amountto send COLX from your wallet to another address.
./colx-cli help to display a complete list of commands. 
./colx-cli help | more to get a complete list of commands and view it one page at a time.

 

Desktop Linux

 If you’re using a graphical desktop version of Linux, you can also use the Linux GUI-based COLX wallet application. Be sure to stop your text-based wallet application first:

 ./colx-cli stop

Then start the GUI-based wallet by typing:

./colx-qt

Additional Resources

As always, if you have any questions, please come find us in the #general-support channel of the ColossusXT discord:

https://discord.gg/aHJKFaX

Average rating: 5 (1 Vote)

You cannot comment on this entry