Installation

Requirements
We want it to be as easy as possible to get started with Cryptitan so we have built an easy to use installer that automatically helps you setup your server and other dependencies such as database, redis, BitGo server, ethereum node, cron jobs, supervisor, nginx, php, websocket service... just to name a few.
To get started you need a VPS Server with nothing installed (i.e. no pre-installed web service) to avoid conflicts with Cryptitan's installer. You can purchase one of these VPS servers using services like AWS EC2 or Digital Ocean Droplets​
You will also need to install SSH client like Putty and WinSCP to connect and upload files to your server. If you are new to connecting and uploading to VPS servers using SSH client, refer to SSH Access section.
SERVER SPECIFICATION
OS: Linux (Ubuntu 18.04 or later)
Architecture: 64bit (x86)
Memory: 4gb+
Storage: 50gb+
Prepare Server
Create a new user account on the server, it is under this account, Cryptitan needs to be installed. Do NOT install Cryptitan as root user! You can create a user account using the following command (where 'neoscrypts' is the username):
sudo useradd -m neoscrypts
For the rest of the installation guide, we will use neoscrypts as reference for the newly created user account.
Our installer leverages the power of Docker container services, so you need to install Docker on the server. (see: docker installation section)
For a complete tutorial on how to connect securely to the newly created user account on your VPS Server via SSH, see: SSH Access section.
Remember to add the username to the Docker group. (refer to docker installation). 
Upload Files
Don't install Cryptitan as root user!
Using your preferred remote file manager (e.g. WinSCP), login as the created user account.
Navigate to the home directory: i.e. /home/neoscrypts
Upload the zip file obtained from the marketplace to the home directory. 
If you don't know how to upload files to your VPS server, refer to the SSH Access section.
Next, using SSH Terminal, login as the created user account, and navigate to the home directory. i.e. /home/neoscrypts/
cd ~
Unzip the uploaded source file
unzip cryptitan-source-file.zip
cryptitan-source-file.zip here is the name of the zip file as downloaded from the marketplace. Example of the zip file, downloaded from CodeCanyon looks like: codecanyon-71g9eMsC-cryptitan-multi...
Now you should have a folder named: cryptitan-1.0.0. 
For convenience sake, rename this folder to just cryptitan
rsync -a cryptitan-1.0.0/ cryptitan/
The ending slash "/" of the source and destination directory is required.
The 1.0.0 in the folder name represents the version you are installing.
Verify the folder /home/neoscrypts/cryptitan which should contain all Cryptitan source files.
Don't rename your project folder, after the first build. If you do so, Cryptitan will rebuild on a new instance, similar to a fresh install.
Setup Environment
While logged in as the created user account (SSH Terminal), Navigate to the project's folder: i.e. /home/neoscrypts/cryptitan
cd ~/cryptitan
Create your .env file using the command:
./cryptitan init-env
Within your project's folder you will find your .env file.  Edit the file and set your information as required. Please refer to Environment section for guide.
Environment
After environment setup, build and start Cryptitan
./cryptitan up -d
If you have properly configured your environment file as described, the server should successfully build and start. It takes about 20 minutes to complete. 
Bind to Network
This will make cryptitan available to the outside world through your domain.
While logged in as the created user account (SSH Terminal).  Navigate to the user's home directory: i.e. /home/neoscrypts/
cd ~
Download the Network tool using the command:
git clone https://github.com/neoscrypts/docker-nginx
Navigate into the created docker-nginx directory, and start it:
./nginx up -d
Your domain, as specified in the environment file, as well as the www. version, must be pointed to your server's IP address. i.e both example.com and www.example.com must be pointed to your server's IP address.
You are set!
Cryptitan should now be accessible through your configured domain. (Make sure your domain is already pointed to your server's IP address)
If you get a 502 Gateway error, this could mean that the server is still compiling its assets, so you have to wait for a few minutes. It could also mean that there is a misconfiguration in your environment file. 
If it is still stuck on the error page after several minutes, You have to check the logs to see the compilation error:  
./cryptitan logs -f application
Take a 5 minute video of it and send it to us, over our support channel, we will be able to tell you which one of your environment value was misconfigured.
Overview
Next - Getting Started
Environment
Last modified 8mo ago
Copy link
Outline