Running DCL on AWS LightSail

Ubuntu-dcl-test

Create the basic Lightsail instance

Create Lightsail instance with ubuntu 22
Let instance boot up
Go to Manage Instance - Networking, and add ports 443 and 10000 to firewall rules
Copy the IP for the Instance

(Optional) Configure a domain name for the test instance

You can also have a domain name which point to the instance so users can acess it via a URL rather than an IP address.

Go to your domain registras admin panel for DNS settings
Create two A NAME records for dcl-test.domain.tld, and *.dcl-test.domain.tld which point to the Lightsail Instance IP
Set these up now so that DNS has time to propagate before we request SSL certificates later

Declare some params:

Update the following with your own details and run them in your terminal so we can reference the values later:

declare DOMAIN="dcl-test.domain.tld"
declare SUDO_USER_PASSWORD="AReallySuperSecretPasswordForTheAdminPanel"

Install dependencies

Run following in terminal to setup system setup:

# Update packages
sudo apt update -y
sudo apt install -y git tmux npm

# Set sudo user passwd
echo "ubuntu:${SUDO_USER_PASSWORD}" | sudo chpasswd

# Preserve hostname on AWS instances
hostnamectl set-hostname --static "${DOMAIN}"
echo "preserve_hostname: true" | sudo tee -a "/etc/cloud/cloud.cfg" > /dev/null
systemctl restart NetworkManager

# Get virtualmin and run installer
wget https://software.virtualmin.com/gpl/scripts/virtualmin-install.sh
sudo sh virtualmin-install.sh --minimal --hostname "${DOMAIN}" --force

# Set some Virtualmin options
sudo virtualmin set-global-feature --default-off virtualmin-awstats
sudo virtualmin disable-feature --mysql --all-domains
sudo virtualmin disable-feature --mail --all-domains
sudo systemctl disable mariadb
sudo systemctl disable postfix
sudo systemctl disable dovecot

Create the domain website and user account

Run the following in terminal:

# Create the website for the domain with a random admin password
webmin_password=$(date +%s|sha256sum|sha256sum|base64|head -c 32)
sudo virtualmin create-domain --domain "${DOMAIN}" --pass "${webmin_password}" --default-features

Configure the SSL certificate

Run the following in a termainl. It must be run with sudo, so must be run under the sudo account, eg ubuntu

This may not work if DNS changes haven't propagated yet, so if it fails due to lack of DNS records try again later.

sudo virtualmin generate-letsencrypt-cert --domain "${DOMAIN}"
sudo virtualmin install-service-cert --domain "${DOMAIN}" --service webmin

Generate SSH keys for the website user

Next, we switch over to the newly created user account.

Note: you will need to update the username.

Your username is the first part of your domain, eg dcl-test

sudo su dcl-test
cd ~
ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519 -C "[email protected]"
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

Copy the SSH public key to GitHub

We need to copy the public key here to your GitHub authorised keys so that the user account has permission to clone repositories.
Run the following to print out the public key of the newly generated keypair:

tail  ~/.ssh/id_ed25519.pub

Go to GitHub -> Settings -> Access -> SSH and GPG Keys -> Add SSH Key
Enter the public key and save

Install NodeJS via NVM, and DCL packages