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

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.


Article is closed for comments.