Setup / Install Ubuntu Server

This guide will help you set up an Ubuntu 18.04 LTS server in preparation for deploying a FreightWise integration.

Minimum Server Requirements

Virtualized (such as Hyper-V or VMware), cloud (such as AWS EC2/ECS, Digital Ocean, Azure), or physical bare-metal servers are all acceptable. The following specs should work:

• 1 GB RAM
• 12 GB Storage
• 1 CPU/vCPU

Installing Ubuntu Server 20.04 LTS

• Download the ISO from Ubuntu.
• If you're provisioning a virtual machine, attach the ISO as a CD. If you're provisioning physical hardware, follow this tutorial to create a bootable USB flash drive for the ISO.
• Install Ubuntu following the official install documentation.

Add SSH Access for FreightWise

Note: This is optional - you can opt for AWS Session Manager access below instead

• Switch to sudo mode: sudo -i
• Create a new user called freightwise: adduser freightwise
• Set a strong password for that user and send it to us.
• Give the new freightwise user sudo access: usermod -aG sudo freightwise
• Switch to the new user: su - freightwise
• Follow this guide starting at Copying Public Key Manually to
  • Add the FreightWise public SSH key to /home/freightwise/.ssh/authorized_keys
  • Disable password authentication for SSH
• If you would like, follow the above guide in its entirety to setup your own SSH key for the user you created during setup.

Install AWS Systems Manager Agent

• Request an activation code and ID from FreightWise
• Run sudo snap install amazon-ssm-agent --classic
• Run sudo snap stop amazon-ssm-agent
• Run sudo /snap/amazon-ssm-agent/current/amazon-ssm-agent -register -code ***CODE PROVIDED BY FREIGHTWISE*** -id ***ID PROVIDED BY FREIGHTWISE*** -region us-east-1
• Run sudo snap start amazon-ssm-agent

Deploy the FreightWise Integration

We will provide a script for you to run that will automate these tasks:

• Setup the Ubuntu firewall (ufw) to only allow incoming SSH connections.
• Enable automated security updates.
• Install Docker Community Edition.
• Deploy the FreightWise integration Docker container.