Cryptitan
Search…
Environment
Your .env file configuration reference.
Your environment values should be set using the pattern VARIABLE=value on new lines each. Notice that there is no space between VARIABLE, = and value
Do NOT add space between values, and if you absolute need to, you have to put them in quotes as such VARIABLE="really long value"
Heads Up! Don't change a variable that we have not explicitly instructed you to change in this document, unless of course, you know what you are doing.
The categories marked with asterisk (*) are required for Cryptitan to successfully build and start. If you skip any one of these, Cryptitan will NOT START!
If any of the variable stated here is not predefined in the environment file, you should write it in a new line at the end of the file.

Application *

APP_NAME set your application name
APP_URL set your domain, e.g. APP_URL=https://example.com
CERTBOT_EMAIL set your official email address

Database *

The database is automatically built within the container of Cryptitan and it is only accessible by Cryptitan itself, so any database credential set is inherently safe.
Database credential must only be set ONCE and not changed afterwards. Because the database is only built one time. If you change the credential, Cryptitan will no longer be able to connect to it.
DB_USERNAME set your database username (any random value will work)
DB_PASSWORD set your database password (any random value will work)

Email

MAIL_HOST set your SMTP host.
MAIL_PORT set your SMTP port.
MAIL_USERNAME set your SMTP username
MAIL_PASSWORD set your SMTP password
MAIL_ENCRYPTION set to "tls" for sending of encrypted mails
MAIL_FROM_ADDRESS set your email "from" address, it could be something like [email protected] This usually requires domain verification on your SMTP server.
MAIL_FROM_NAME set your email "from" name. You can leave it as "${APP_NAME}" to set your APP_NAME

BitGo *

BITGO_TOKEN set your BitGo access token, (refer to its section for guide)
BITGO_ENV sets your BitGo to test or prod environment.
Don't change your BitGo environment after setup! Wallet balances of users are always retained, and you don't want a user's account that was credited on a testnet environment to be able to withdraw the same value on a production environment. You typically want to have two installations of Cryptitan for the two environment. One installation will be for testing purpose, while the other is for production.

HCaptcha

RECAPTCHA_ENABLE set as true or false to enable or disable HCaptcha.
RECAPTCHA_SECRET set your HCaptcha secret
RECAPTCHA_SITEKEY set your HCaptcha site key
RECAPTCHA_SIZE set to normal or invisible

Pusher

You don't need to obtain API keys from Pusher because Cryptitan hosts its own WebSocket service. You should leave the environment values as they are.

Redis

A redis server is automatically built with Cryptitan's network and it is only accessible to cryptitan, which makes it inherently safe. Leave the redis information as it is and you are good to go!

Open Exchange Rates *

OPEN_EXCHANGE_RATES_APP_ID set your openexchangerates.org app id. (refer to its section)

Maxmind *

GEOIP_SERVICE set your maxmind service. This can be one of maxmind_api or maxmind_database
MAXMIND_USER_ID set your maxmind user id (refer to its section)
MAXMIND_LICENSE_KEY set your maxmind license key (refer to its section)

Ethereum

GETH_NETWORK sets the network of ethereum to connect to. It can be one of mainnet or goerli. Mainnet is the network that handles REAL ethereum value. Its best to leave it unchanged if you don't know about ethereum networks.
ETHEREUM_WS (optional) If you want to switch to a more stable ethereum node service, set the destination WebSocket node URL here. When absent, it defaults to the internal GETH node. We recommend: Chainstack
Don't change Ethereum Network after setup! Wallet balances of users are always retained, and you don't want a user's account which was credited on a testnet environment to be able to withdraw the same value on a production environment. You typically want to have two installations of Cryptitan for the two environment. One installation will be for testing purpose, while the other is for production.
Cryptitan is bundled with a light ethereum node (GETH), which can be unstable sometimes. We recommend you switch to a more stable service using Chainstack.

Binance *

BINANCE_WS (required) sets the destination WebSocket node URL for Binance network. We recommend: Chainstack
Don't change Binance Network after setup! Wallet balances of users are always retained, and you don't want a user's account which was credited on a testnet environment to be able to withdraw the same value on a production environment. You typically want to have two installations of Cryptitan for the two environment. One installation will be for testing purpose, while the other is for production.

SMS Provider

SMS_PROVIDER set your SMS provider, this could be one of nexmo, twilio, africastalking, sns. Each requires its own specific environment values, refer to their section.

Nexmo

NEXMO_KEY set your nexmo key (refer to its section)
NEXMO_SECRET set your nexmo secret (refer to its section)
NEXMO_PHONE set your nexmo phone number

Twilio

TWILIO_AUTH_TOKEN set your Twilio auth token
TWILIO_ACCOUNT_SID set your Twilio account SID
TWILIO_FROM set your Twilio number
TWILIO_SMS_SERVICE_SID set your Twilio sms service SID
TWILIO_ALPHA_SENDER (optional) set your Twilio sender name
TWILIO_SMS_SERVICE_SID (optional) set your sms service ID

AfricasTalking

You need to Register and then go to your sandbox app Go To SandBox App, Click on settings Within this page, you will generate your Username and key.
Remember to add your Sender ID that you will be using to send the messages.
AT_USERNAME set your AfricasTalking username
AT_KEY set your AfricasTalking secret key
AT_FROM set your AfricasTalking Sender ID

PayPal

PAYPAL_CLIENT_ENV set to either sandbox or live
PAYPAL_CLIENT_ID set your PayPal client ID
PAYPAL_CLIENT_SECRET set your PayPal client secret
After subsequent changes to the environment file in the future. Remember to rebuild Cryptitan with:
./cryptitan recreate

Stripe

STRIPE_ENABLE set to either true or false
STRIPE_KEY set your Stripe secret key here

PayU

PAYU_ENABLE set to either true or false
PAYU_CLIENT_ENV set to either secure or sandbox for production or test environment.
PAYU_CLIENT_ID set your OAuth Client ID
PAYU_CLIENT_SECRET set your OAuth Client Secret
PAYU_CURRENCY set your PayU account currency

Paystack

PAYSTACK_ENABLE set to either true or false
PAYSTACK_CLIENT_SECRET set your Secret Key here

Mollie

MOLLIE_ENABLE set to either true or false
MOLLIE_CLIENT_KEY set your API key here