Installation

Installation

General information

Installing tracks from source code is complicated. Possible ways of getting tracks running are:

• Docker image run on either Docker Compose or directly as a container
• Custom environment installing the necessary libraries and installing the source yourself.
• TurnKey Linux offers prebuilt Tracks appliances in several formats.
• If you want to use a hosted service, then look at the list of free and commercial tracks hosted services at Hosted Tracks.

The official installation instructions covering the Docker and source install options are available in doc/installation.md. Below are some more specific instructions for distributions and hosting providers.

Note: The distribution and hosting service specific instructions are likely to get out-of-date if they haven’t been updated recently. Please update them if you notice something missing or wrong. The maintainer only updates the instructions mentioned above.

Distribution-specific instructions

Below are some more specific instructions on various platforms.

Not very recently updated installation instructions

• Staannoe's Docker image

• Debian 6.0 minimal setup
• Ubuntu 11.04 minimal setup with Tracks 2.0 (or git sources)
• Ubuntu 11.04 with lighttpd and SSL for Tracks 2.0 (or git sources)
• Install Tracks 2.1 on Ubuntu 12.04
• Install Tracks 2.5 on Ubuntu 20.10
• Installing Tracks from git on Gentoo (ebuild)
• Installing Tracks on OpenShift and using Mailgun to email todos to Tracks
• Installing Tracks 2.2.2 on CentOS 6.5 Minimal x86_64
• Installing Tracks 2.3.0 on Ubuntu 14.04 LTS on AWS with SSL support
• Upgrade from 2.4.2 to 2.5.1 on AWS Ubuntu 18.04 LTS (September 2020)

Past install instructions

• MacOS X
• Windows (or install on a USB stick using this guide)
• Windows 7 64 bit
• Linux Debian
• Install Tracks 1.7.1 on Ubuntu 10.04
• Linux opensuse
• FreeBSD
• Fedora
• CentOS 5
• Scientific Linux (RH5 clone)
• Apache
• OpenSolaris

Specific instructions for webhosters:

Installing Tracks on a webhost’s server

• 1and1 – Debian, Ruby 1.8.5
• Bluehost
• Dreamhost
• GoDaddy
• Heroku
• Hostgator
• Mavenhosting service - CentOS and cPanel
• Media Temple gs
• OpenShift
• Stablehost
• Uberspace

Recommended web hosts

Here are some web hosts recommended by users which allow you to install Tracks and therefore use it from any internet-connected computer:

• Joyent: Where bsag hosts the Tracks project, her blog and her own private version of Tracks. They have all you need to install Rails applications, and great technical support.
• Slicehost: Built for developers. We offer 256/512/1024 Xen VPS Slices with choice of OS (Ubuntu, CentOS, Gentoo). The 256 is perfect for hosting Tracks and we’re big fans. Full root access – run Apache, Lighttpd, Mongrel, Webrick – your choice. Please contact us or pop into the chatroom with any questions.
• Site5: Installed and works without any problem.