ColossusXT Linux / VPS Wallet 1.1.1 Setup Guide
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:
- All Linux commands are CASE SENSITIVE. ALWAYS pay close attention to case.
~symbol is a shortcut to the current user’s home folder, which is
/home/usernamefor 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.
- 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.datfile 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:
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:
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
This guide is written with the assumption that you are logged in as
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).
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:
Download The 1.1.1 ColossusXT Wallet Program From Github
wget command to download the 1.1.1 wallet archive directly to your
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:
wget -P ~/Downloads https://github.com/ColossusCoinXT/ColossusCoinXT/releases/download/v1.1.1/colx-1.1.1-x86_64-linux-gnu.tar.gz
wget -P ~/Downloads https://github.com/ColossusCoinXT/ColossusCoinXT/releases/download/v1.1.1/colx-1.1.1-i686-pc-linux-gnu.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:
tar xvzf ~/Downloads/colx-1.1.1-x86_64-linux-gnu.tar.gz -C ~
tar xvzf ~/Downloads/colx-1.1.1-i686-pc-linux-gnu.tar.gz -C ~
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
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:
This will open your config file in the text editor. Add the following line of text:
When you are done, press
[CTRL]+X to exit.
Y at the “Save modified buffer?” prompt:
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
cd command to navigate to your new ColossusXT program folder and launch the ColossusXT wallet application:
The console should now indicate that the server is starting:
Now check the wallet status :
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
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
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:
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.
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:
Then start the GUI-based wallet by typing:
As always, if you have any questions, please come find us in the #general-support channel of the ColossusXT discord: