Deploying Trains Server: AWS EC2 AMIs

Deploy Trains Server to an AWS EC2 instance using use one of our pre-built Amazon Machine Images (AMIs). Trains provides AMIs per region for each released version of Trains Server. For a list of our pre-built AMIs, see Released versions.

Installing

To install Trains Server, see the AWS Knowledge Center about Launching a custom AMI from the EC2 console, or detailed instructions in the AWS Documentation for Launching an Instance Using the Launch Instance Wizard.

The minimum recommended amount of RAM is 8 GB. For example, t3.large or t3a.large would have the minimum recommended amount of resources.

Port mapping

After deploying Trains Server, the services expose the following node ports:

  • Web server on 8080.
  • API server on 8008.
  • File Server on 8081.

Storage configuration

The pre-built Trains Server storage configuration is the following:

  • MongoDB: /opt/trains/data/mongo/
  • Elasticsearch: /opt/trains/data/elastic/
  • File Server: /mnt/fileserver/

Upgrading Trains Server

To upgrade Trains Server on an existing EC2 instance based on one of these AMIs, SSH into the instance and follow the upgrade instructions for Trains Server.

Upgrading AMI's from versions 0.11.0 or older

If your AMI is version 0.12.0 or newer, then the update is fully automatic.

This upgrade includes the automatically updated AMI. It also includes an additional REDIS docker to the Trains Server setup.

To upgrade the AMI from versions 0.11.0 or older, do the following:

  1. SSH to the EC2 machine running one of the latest version AMI's.
  2. Execute the following bash commands:
    sudo bash
    echo "" >> /usr/bin/start_or_update_server.sh
    echo "sudo mkdir -p \${datadir}/redis" >> /usr/bin/start_or_update_server.sh
    echo "sudo docker stop trains-redis || true && sudo docker rm -v trains-redis || true" >> /usr/bin/start_or_update_server.sh
    echo "echo never | sudo tee -a /sys/kernel/mm/transparent_hugepage/enabled" >> /usr/bin/start_or_update_server.sh
    echo "sudo sysctl vm.overcommit_memory=1" >> /usr/bin/start_or_update_server.sh
    echo "sudo docker run -d --restart=always --name=trains-redis -v \${datadir}/redis:/data --network=host redis:5 redis-server" >> /usr/bin/start_or_update_server.sh
    
  3. Reboot the EC2 machine.

Released AMI versions

The following sections contain lists of AMI Image IDs, per region, for each released Trains Server version.

Latest version - v0.14.0 (auto update)

  • eu-north-1 : ami-050c24cc0099e9512
  • ap-south-1 : ami-07bb33de49e319d73
  • eu-west-3 : ami-00ecdf092af972d24
  • eu-west-2 : ami-09ace28116ad33dd9
  • eu-west-1 : ami-01d85e00c7741d69b
  • ap-northeast-2 : ami-0ccc3d85996362545
  • ap-northeast-1 : ami-06abda05aa2407b1a
  • sa-east-1 : ami-0ce3597b116cfdd79
  • ca-central-1 : ami-0cb2d22a74007fa14
  • ap-southeast-1 : ami-06a9784d792a7c30f
  • ap-southeast-2 : ami-012ab6092f28f62b6
  • eu-central-1 : ami-04443efac619cac6d
  • us-east-2 : ami-05391549da2d5e38c
  • us-west-1 : ami-0444959077f5f7310
  • us-west-2 : ami-029b979c20d7f16f3
  • us-east-1 : ami-024ab496fe05a4b4d

v0.14.0 (static - no auto update)

  • eu-north-1 : ami-02de71586ec496e38
  • ap-south-1 : ami-074b03849b51852e5
  • eu-west-3 : ami-022c388835e0eeb03
  • eu-west-2 : ami-0a151c236c6b27707
  • eu-west-1 : ami-06de69b06b4e73312
  • ap-northeast-2 : ami-0ee821b72d9f669b1
  • ap-northeast-1 : ami-03687ae215e64e100
  • sa-east-1 : ami-01eb83364b7f667af
  • ca-central-1 : ami-02e9b35f9c90377e6
  • ap-southeast-1 : ami-0d3ab5ab0048fea51
  • ap-southeast-2 : ami-0bd39d908fe3a9e06
  • eu-central-1 : ami-0b8638701311b35c4
  • us-east-2 : ami-02ff039693fc3a614
  • us-west-1 : ami-08634f7dfb608a9a7
  • us-west-2 : ami-034d693ef742b9333
  • us-east-1 : ami-0b828b05c323dde7f

v0.13.0 (auto update)

  • eu-north-1 : ami-0ad83a75fa3e2c80b
  • ap-south-1 : ami-075ddc836bc32fe53
  • eu-west-3 : ami-07db267b1f2d37061
  • eu-west-2 : ami-094dc10923edfd1d0
  • eu-west-1 : ami-0fe9104f30eede70d
  • ap-northeast-2 : ami-0934d926700efd9cc
  • ap-northeast-1 : ami-074e99a3a21e1b458
  • sa-east-1 : ami-066bfdb970b103bc7
  • ca-central-1 : ami-084f181a04bba7773
  • ap-southeast-1 : ami-0182d08660fb380ee
  • ap-southeast-2 : ami-0eb6d5b6b28eac987
  • eu-central-1 : ami-09d1db938b6fe1da0
  • us-east-2 : ami-05d6c4e069edd226a
  • us-west-1 : ami-08b5c351a9c3c1cb1
  • us-west-2 : ami-07f3bb539505230d5
  • us-east-1 : ami-04438f02ae5450d7f

v0.13.0 (static - no auto update)

  • eu-north-1 : ami-0d9c74a015e7510d8
  • ap-south-1 : ami-02acd6dd0659bb5c1
  • eu-west-3 : ami-0f0cc5cb6d9afd194
  • eu-west-2 : ami-0298fdc0860206ed9
  • eu-west-1 : ami-0cdc072e528401d5e
  • ap-northeast-2 : ami-0055579cc95b0e53e
  • ap-northeast-1 : ami-0ced7becb9b83b5d0
  • sa-east-1 : ami-033345d0f16a1b5e4
  • ca-central-1 : ami-06c63b05aed47ae67
  • ap-southeast-1 : ami-09f0355f367f30602
  • ap-southeast-2 : ami-0bd2314163ce0fba0
  • eu-central-1 : ami-05fbae957df63e366
  • us-east-2 : ami-050c51b5b4074d3fc
  • us-west-1 : ami-06ad513073d4e5a19
  • us-west-2 : ami-0c96e1361d1d4ca94
  • us-east-1 : ami-07b669040d1eea213

v0.12.1 (static update)

  • eu-north-1 : ami-003118a8103286d84
  • ap-south-1 : ami-02dfe86baa48e096f
  • eu-west-3 : ami-0cc1f01267d2a780d
  • eu-west-2 : ami-0e4c8332e5ce09585
  • eu-west-1 : ami-03459a2f0b0a3b1ab
  • ap-northeast-2 : ami-08f6c2aed3a53f24c
  • ap-northeast-1 : ami-0b798eab95a7c5435
  • sa-east-1 : ami-0d3ee166c09f0d1b2
  • ca-central-1 : ami-00a758c56bd63acd5
  • ap-southeast-1 : ami-0be64d4988cd03fbb
  • ap-southeast-2 : ami-02087310d43a63f31
  • eu-central-1 : ami-097bbefeac0c74225
  • us-east-2 : ami-07eda256712b90f4d
  • us-west-1 : ami-02ef2b55cbd01c7df
  • us-west-2 : ami-037c6176ef4735360
  • us-east-1 : ami-08715c20c0e3f1c15

v0.12.0 (static - no auto update)

  • eu-north-1 : ami-03ff8ab48cd43e77e
  • ap-south-1 : ami-079c1a41ff836487c
  • eu-west-3 : ami-0121ef0398ae87ab0
  • eu-west-2 : ami-09f0f97654d8c79de
  • eu-west-1 : ami-0b7ba303f757bfcd9
  • ap-northeast-2 : ami-053f416517b5f40a6
  • ap-northeast-1 : ami-056dff06c698c2d9d
  • sa-east-1 : ami-017ab655119258639
  • ca-central-1 : ami-03bf5fa1d86ac97f6
  • ap-southeast-1 : ami-0e667958002b0360c
  • ap-southeast-2 : ami-091f1b69cb43b1933
  • eu-central-1 : ami-068ec2f0e98c26541
  • us-east-2 : ami-0524bbdc1b64ff83f
  • us-west-1 : ami-0b4facd7534e393c9
  • us-west-2 : ami-0018d5a7e58966848
  • us-east-1 : ami-08f24178fc14a84d2

v0.11.0 (static - no auto update)

  • eu-north-1 : ami-0cbe338f058018c97
  • ap-south-1 : ami-06d72ff894f7a5e5d
  • eu-west-3 : ami-00f2a45d67df2d2f3
  • eu-west-2 : ami-0627ae688f4533237
  • eu-west-1 : ami-00bf924ccb0354418
  • ap-northeast-2 : ami-0800edf1d1dec1da8
  • ap-northeast-1 : ami-07b2ed9709cdc4b15
  • sa-east-1 : ami-0012c1648618b812c
  • ca-central-1 : ami-02870b965d002fc8a
  • ap-southeast-1 : ami-068ec23abf2473192
  • ap-southeast-2 : ami-06664624728b5e01a
  • eu-central-1 : ami-05f2a9304f237a6f0
  • us-east-2 : ami-0ec242e6dca2b72b9
  • us-west-1 : ami-050b6577acf246ceb
  • us-west-2 : ami-0e384b6f78bf96ebe
  • us-east-1 : ami-0a7b46f907d5d9c4a

v0.10.1 (static - no auto update)

  • eu-north-1 : ami-09937ec4d18350c32
  • ap-south-1 : ami-089d6ba7541ec4c7f
  • eu-west-3 : ami-0accb1a94bdd5c5c1
  • eu-west-2 : ami-0dd2c97bc678b8570
  • eu-west-1 : ami-07a38865cbe7ca3cb
  • ap-northeast-2 : ami-09aa0b7fe1cf3dd55
  • ap-northeast-1 : ami-0905e7d1543e5ed36
  • sa-east-1 : ami-08c0627daa67d7372
  • ca-central-1 : ami-034add081712ff648
  • ap-southeast-1 : ami-0c6caee3689b6e066
  • ap-southeast-2 : ami-04994afd8dae5b417
  • eu-central-1 : ami-06b10f8c30e1434f1
  • us-east-2 : ami-0d3abe7a1fec535cc
  • us-west-1 : ami-02bb610b70c55018b
  • us-west-2 : ami-0d1cb8ba7de246ff0
  • us-east-1 : ami-049ccba6abdb40cba

v0.10.0 (static - no auto update)

  • eu-north-1 : ami-05ba33c763877e54e
  • ap-south-1 : ami-0529eec569161cae5
  • eu-west-3 : ami-03cb9396f63e26ff6
  • eu-west-2 : ami-0dd28cc97283cc201
  • eu-west-1 : ami-059cf379ae14b0a24
  • ap-northeast-2 : ami-031409d71f1280616
  • ap-northeast-1 : ami-0171437c68b3660aa
  • sa-east-1 : ami-0eb440a3b6e591c7a
  • ca-central-1 : ami-097da9ec155ee654a
  • ap-southeast-1 : ami-0ab7ff3ea09826e39
  • ap-southeast-2 : ami-00969c550ef2d1f60
  • eu-central-1 : ami-02246400c51990acb
  • us-east-2 : ami-0cafc1d730381d6fa
  • eu-central-1 : ami-02246400c51990acb
  • us-west-1 : ami-0e82a98ddbe995a65
  • us-west-2 : ami-04a522ecb2250fb44
  • us-east-1 : ami-0a66ddbd50959f91e

v0.9.0 (static - no auto update)

  • us-east-1 : ami-0991ad536ecbacdac
  • eu-north-1 : ami-07cbcdff501b14afe
  • ap-south-1 : ami-014cf398b00d4db83
  • eu-west-3 : ami-0396ba51e9b733581
  • eu-west-2 : ami-09134f4c7a20bad09
  • eu-west-1 : ami-00427ed0a1bbfa7b0
  • ap-northeast-2 : ami-041756675ca1be954
  • ap-northeast-1 : ami-0c09ebad05c9128ff
  • sa-east-1 : ami-017a8de4e8d1e8c8e
  • ca-central-1 : ami-049ec444470f852be
  • ap-southeast-1 : ami-0c919b8f821a6c635
  • ap-southeast-2 : ami-04844a0594712d27b
  • eu-central-1 : ami-0b4e756e0f7c0617d
  • us-east-2 : ami-03b01914b07428488
  • us-west-1 : ami-0cf4768e9d47ed076
  • us-west-2 : ami-0b145f37da31eb9fb

Next Step