Select your platform

Ubuntu

Debian

CentOS / Fedora

Other Linux

Windows

Server Core

Install instructions for Ubuntu

Requirements

  • Ubuntu 16.04 64-bit or newer (18.04+ Recommended)
  • Root access via SSH

Quick install

Recommended for new Linux users installing AMP for the first time.

Run the following command:

sudo su -c "bash <(wget -qO- getamp.sh)"

This script will automatically install any dependencies, create a new system user and get you started.
You will be prompted for a set of login details to use. Once the wizard completes, you're done!

Advanced Install

Create a new user to run AMP as

This is not an optional step. AMP will refuse to start if you try and run it as root or as a user that has root permissions.

sudo useradd -d /home/AMP -m AMP -s /bin/bash
sudo passwd AMP

Add the CubeCoders repository to your system

sudo apt-get install software-properties-common dirmngr apt-transport-https
sudo apt-key adv --fetch-keys http://repo.cubecoders.com/archive.key
sudo apt-add-repository "deb http://repo.cubecoders.com/ debian/"
sudo apt update

Add firewall rules for AMP

sudo ufw allow from any to any port 8080 proto tcp

Install the AMP instance manager

sudo apt install ampinstmgr --install-suggests

Note: the --install-suggests flag is only required if you intend to run srcds based servers such as Team Fortress 2 or Counter-Strike: Global Offensive

Login as the AMP user and create a management instance

sudo su -l AMP
ampinstmgr quickstart USERNAME PASSWORD

Replacing USERNAME and PASSWORD with your desired login details. After this step you may open a browser to your servers IP address on port 8080 (http://1.2.3.4:8080) and begin managing AMP

Optional - make AMP automatically start on boot

(crontab -l ; echo "@reboot /opt/cubecoders/amp/ampinstmgr -b")| crontab -

Updating AMP

Updating the instance manager

Run the following to update the instance manager command line tool:

sudo apt update
sudo apt upgrade

Updating the AMP instances

Login as the AMP user or switch over to it using

sudo su -l AMP
and then run:

ampinstmgr upgradeall

 

Install instructions for Debian

Requirements

  • Debian 8 64-bit or newer (Debian 9 Recommended)
  • Root access via SSH

Quick install

Recommended for new Linux users installing AMP for the first time.

Run the following command as root:

bash <(wget -qO- getamp.sh)

This script will automatically install any dependencies, create a new system user and get you started.
You will be prompted for a set of login details to use. Once the wizard completes, you're done!

Advanced Install

Run the following commands as root:

Create a new user to run AMP as

This is not an optional step. AMP will refuse to start if you try and run it as root or as a user that has root permissions.

useradd -d /home/AMP -m AMP -s /bin/bash
passwd AMP

Add the CubeCoders repository to your system

apt-get install software-properties-common dirmngr apt-transport-https iptables-persistent
apt-key adv --fetch-keys http://repo.cubecoders.com/archive.key
apt-add-repository "deb http://repo.cubecoders.com/ debian/"
apt update

Add firewall rules for AMP

iptables -A INPUT -p tcp -m tcp --dport 8080 -j ACCEPT
iptables-save > /etc/iptables/rules.v4

Install the AMP instance manager

apt install ampinstmgr --install-suggests

Note: the --install-suggests flag is only required if you intend to run srcds based servers such as Team Fortress 2 or Counter-Strike: Global Offensive

Login as the AMP user and create a management instance

su -l AMP
ampinstmgr quickstart USERNAME PASSWORD

Replacing USERNAME and PASSWORD with your desired login details. After this step you may open a browser to your servers IP address on port 8080 (http://1.2.3.4:8080) and begin managing AMP

Optional - make AMP automatically start on boot

(crontab -l ; echo "@reboot /opt/cubecoders/amp/ampinstmgr -b")| crontab -

Updating AMP

Updating the instance manager

Run the following as root to update the instance manager command line tool:

apt update
apt upgrade

Updating the AMP instances

Login as the AMP user or switch over to it using

su -l AMP
and then run:

ampinstmgr upgradeall

 

Install instructions for CentOS

Requirements

  • CentOS 7 64-bit / Fedora 28 or newer
  • Root access via SSH

Note: Some applications supported by AMP require a newer version of glibc or other system libraries than CentOS 7 ships with. Factorio for example requires glibc 2.18 or newer. As such these applications will not be usable on CentOS 7 natively. You can confirm the version of glibc that is installed by running `ldd --version`

CentOS users wishing to run these applications may need to condsider using another distribution, or having ampinstmgr create instances inside Docker containers which sidesteps the issue.

Log in as root and perform the following steps in order:

Create a new user to run AMP as

This is not an optional step. AMP will refuse to start if you try and run it as root or as a user that has root permissions.

useradd -d /home/AMP -m AMP -s /bin/bash -G tty
passwd AMP

Install prerequisites

yum install tmux socat unzip git wget

If you want to run srcds based servers such as Team Fortress 2 or Counter Strike: Global Offensive, you'll also require these extra dependencies:

yum install glibc.i686 libstdc++.i686

Add firewall rules for AMP

firewall-cmd --zone=public --add-port=8080/tcp --permanent
firewall-cmd --reload

Installing AMP

Then you can download and install AMP:

mkdir -p /opt/cubecoders/amp
cd /opt/cubecoders/amp
wget http://cubecoders.com/Downloads/ampinstmgr.zip
unzip ampinstmgr.zip
rm -i ampinstmgr.zip
ln -sf /opt/cubecoders/amp/ampinstmgr /usr/bin/ampinstmgr

Login as the AMP user and create a management instance

sudo su -l AMP
ampinstmgr quickstart USERNAME PASSWORD

Optional - make AMP automatically start on boot

(crontab -l ; echo "@reboot /opt/cubecoders/amp/ampinstmgr -b")| crontab -

Updating AMP

Updating the instance manager

Login as root and run the following:

cd /opt/cubecoders/amp
wget http://cubecoders.com/Downloads/ampinstmgr.zip
unzip -o ampinstmgr.zip
rm -i ampinstmgr.zip

Updating the AMP instances

Login as the AMP user or switch over to it using

sudo su -l AMP
and then run:

ampinstmgr upgradeall

 

Install instructions for other Linux distributions

These instructions are only a rough guide, please consult your distributions specific documentation for steps such as changing firewall rules.

Requirements

  • Linux Kernel 3.2 64-bit or newer (Except when using OpenVZ)
  • Root access via SSH
  • GLIBC 2.18 or newer (run `ldd --version` to check)

Create a new user to run AMP as

This is not an optional step. AMP will refuse to start if you try and run it as root or as a user that has root permissions.

useradd -d /home/AMP -m AMP -s /bin/bash
sudo passwd AMP

Install prerequisites

Install the following applications via your distributions package manager

tmux socat unzip git wget

This is not a runnable command, please consult your distributions documentation for how to install these packages.

Additionally, if you intend to run srcds based servers such as Team Fortress 2 or Counter-Strike: Global Offensive you will need 32-bit versions of glibc and the c++ standard libraries (libstdc++) for your distribution.

Add firewall rules for AMP

This assumes that your distribution uses iptables. If your distribution uses another firewall manager such as firewalld or ufw please consult your distributions documentation.

iptables -A INPUT -p tcp -m tcp --dport 8080 -j ACCEPT
iptables-save > /etc/iptables/rules.v4

Installing AMP

Then you can download and install AMP:

mkdir -p /opt/cubecoders/amp
cd /opt/cubecoders/amp
wget http://cubecoders.com/Downloads/ampinstmgr.zip
unzip ampinstmgr.zip
rm -i ampinstmgr.zip
ln -s /opt/cubecoders/amp/ampinstmgr /usr/local/bin/ampinstmgr

Login as the AMP user and create a management instance

sudo su -l AMP
ampinstmgr quickstart USERNAME PASSWORD

Optional - make AMP automatically start on boot

(crontab -l ; echo "@reboot /opt/cubecoders/amp/ampinstmgr -b")| crontab -

Updating AMP

Updating the instance manager

Login as root and run the following:

cd /opt/cubecoders/amp
wget http://cubecoders.com/Downloads/ampinstmgr.zip
unzip -o ampinstmgr.zip
rm -i ampinstmgr.zip

Updating the AMP instances

Login as the AMP user or switch over to it using

sudo su -l AMP
and then run:

ampinstmgr upgradeall

 

Install instructions for Windows (Desktop Platforms)

Requirements

  • Windows Server 2012 R2/Windows 8.1 64-bit or newer
  • Administrator access via remote desktop or physical access
  • .Net Framework 4.6.2
  • UAC Enabled (AMP will not function correctly if UAC has been disabled!)

Create a new user to run AMP as

AMP will not run as the built in Administrator user on Windows. Attempting to manage instances or access the file system while logged in as Administrator may result in permissions issues that can cause AMP or applications running within it to stop working properly. Please ensure that you only use your AMP user when working with this software.

  1. Start -> Computer Management
  2. Select 'Local Users and Groups' from the left
  3. Left click Users to select it, then right click to add a new user with a username of AMP
  4. Right click the new user in the Users list, enter its Properties and add it to the Administrators group

Install the AMP Instance Manager

Download the installer and run through the wizard

 Download Windows Installer

 

By default the installer will use the drive with the most available free space as the datastore for AMP instances. If you wish to pick a different location you can chose this by using the 'Custom' option during setup.

Create an ADS Instance

Start the AMP Instance Manager (available via the Start menu) - you will be prompted for an AMP licence key. Once supplied you should create an ADS instance. This will allow you to create and manage additional applications instances via a web interface

You should install ADS as a service. You may if you wish select the option to start on boot.

Once this step is complete you may open up a browser on your servers IP and the port specified (default is 8080) to continue setting up AMP.

 

Install instructions for Windows Server Core (Headless)

Note: This guide may also be used for Desktop Experience installations.

These instructions are incomplete and lacking certain minor details.

Requirements

  • Windows Server 2016 Core or Newer
  • Administrator access with Powershell
  • .Net Framework 4.6.2
  • UAC Enabled (AMP will not function correctly if UAC has been disabled!)

Create a new system user

AMP cannot be run as the built in 'Administrator' user - a new user is required. This user should be part of the Administrators group if you need to create service instances.

Run the following in powershell as Administrator (The first command will prompt for a password):

$Password = Read-Host -AsSecureString
New-LocalUser AMP -Password $PASSWORD -FullName "AMP User"
Add-LocalGroupMember -Group "Administrators" -Member "AMP"

Download and install the instance manager

Login as your new AMP user, then open up PowerShell as administrator and run:

wget https://cubecoders.com/Downloads/AMPSetup.msi
.\AMPSetup.msi /qn

By default the AMP datastore is placed in the "AMPDatastore" directory on the drive with the most free space. If you wish to manually specify a location then you can add the DATASTOREDIR argument:

.\AMPSetup.msi /qn DATASTOREDIR="D:\AMPDatastore\"

Specifying whichever directory you wish as the DATASTOREDIR - ensure this area is somewhere writable by any user. It should not be placed within the "Users" directory.

Creating the management instance

Log out and back in again so that environment variable changes are applied, and then run:

ampinstmgr quickstart USERNAME PASSWORD

 

Decoration