...
CAS installation takes about 20 minutes. Hire a professional to help you if you are uncertain of how to proceed, or if you don’t feel comfortable with typing at the command line.
...
You’ll need a server with a publicly exposed IP to host your CAS.
Instructions: Create a VPS on Digital Ocean
Private servers (behind a router) are possible - but unsupported.
Minimum requirements:
1 CPU
8 GB RAM
20 GB HDD (150GB+ recommended)
Ubuntu 22.04 LTS Server
1 publicly accessible IP address
A valid CAS license key from General Bytes (order here)
...
This guide presumes you've installed a bare Ubuntu 22.04 LTS OS, without any additional software aside from perhaps a distribution upgrade. This guide further presumes root access, and sudo may be required (yet omitted) in some examples supplied below. This guide assumes root for all commands. Security is also assumed. You are running a currency exchange and hackers would love to gain access to your funds. Make it hard difficult for them! Spend some time learning the best practices for your digital security, and implement those practices! . So, let's get going.
First: Login to your server.
You must access your “headless” Linux Ubuntu server using SSH.
Using Linux or Mac, this is rather straightforward. Open a terminal window and SSH into your server:
...
Windows Subsystem for Linux offered by Microsoft for Windows 10 & Windows 11.
PuTTY is a little dated, but still used by millions. Windows implements a CR+LF in it’s text documents, so edit files using Linux/Ubuntu when possible to avoid that issue.
Regardless of what you use, implement SSH keys (on your server) and disable passwords – remember: people want to steal your money! Password authentication usually makes that easier.
...
| Code Block |
|---|
sudo apt update && sudo apt dist-upgrade |
when When asked, “
Do you want to continue? [Y/n] y" reply “y”.if If asked, “keep the local version currently installed” is the safe (at this point)answer.
press Press Enter (when requested) to accept the default answers to any queries (allow the update process to do whatever it suggests). There may be several of these messages.
...
| Code Block |
|---|
sudo apt update && sudo apt install batm |
...
Add execute permission to the script file:
| Code Block |
|---|
sudo chmod +x /opt/batm/batm-install |
...
Start the installation script:
...
Installation will only begin if the key is valid, and
your key will only be valid after your (Operator) KYC approval by GB, and
any outstanding invoices are satisfied.
If you don’t already have a license (signatures are required), order it from: https://www.generalbytes.com/en/products/cas-server
...
| Code Block |
|---|
sudo /opt/batm/batm-install configure |
If you already have SQL installed & configured, use the skip-mysql parameter to proceed without the standard scripted mySQL configuration (e.g. sudo /opt/batm/batm-install configure skip-mysql).
Do not include the skip-mysql parameter unless you have already configured mySQL.
Immediately the script will ask you to create some database credentials.
You'll probably be safe using these defaults for these questions, but to avoid being predictable - pick something unique (yet simple).
The answers are case-sensitive.
These fields must not contain spaces (e.g. “mycas” is permitted, but “my cas” will fail).
DO NOT use special characters in the credentials.
| Note |
|---|
IF YOU ARE PERFORMING A SERVER MIGRATION: Make sure that the database name, username, and password are identical to the source server, or the restore will fail! |
...
This version may not be the latest current version (it is the current stable version).
The “latest version” - may not be. In this example, the installed version IS NOT the latest version, so we should update it next to ensure all possible security updates are applied.
...
Update your CAS
| Note |
|---|
The version installed may not be the latest stable version. |
Follow this guide to install the latest version and/or patch:
...
Activate the integrated VPN to enable access to CAS. You cannot access CAS unless a VPN is configured and active. Only OpenVPN is supported at this time.
Instructions: VPN Server Access for AdminCAS Administration
The integrated method is recommended as the bare minimum.
Server security is your responsibility and any lapse may result in a substantial loss of funds.
...