Installation Guides

To use the Transporter GUI you must install The Transporter (iTMSTransporter). Once installed you can run one of our Docker images or install it for your system.

Docker Image

1. Install Docker
2. Run our Docker image

System Install

1. Install your system's dependencies
2. Install The GUI

System Dependencies

Windows

Install Ruby with DevKit. If you're using MySQL you must use Ruby < 2.4.

• Ruby 2.3 With DevKit

  • x86 (32 Bit)
  • x64 (64 Bit)

• Ruby 2.4 With DevKit

  • x86 (32 Bit)
  • x64 (64 Bit)

All Ruby downloads can be found here

GNU/Linux

All dependencies should be installed as the root user. See distribution specific list below.

Fedora

yum install ruby.x86_64
yum install ruby-devel.x86_64
yum install gcc.x86_64
yum install make.x86_64
yum install sqlite-devel.x86_64 # or whatever DB you use

Ubuntu

apt install openjdk-8-jre # required by iTMSTransporter
apt install ruby2.3
apt install ruby2.3-dev
apt install build-essential
apt install zlib1g-dev
apt install liblzma-dev
apt install libffi-dev
apt install libxml2-dev
apt install libxslt1-dev
apt install libsqlite3-dev # or whatever DB you use

iTunes Store Transporter GUI

After installing your system's dependencies, from the itunes_store_transporter_web root directory run:

ruby install.rb

Now follow the prompts.

For installation options see ruby install.rb --help.

Information on starting/stopping the web server and workers, and configuring The GUI can be found here.