Select your platform

Ubuntu

Debian

CentOS

Other Linux

Windows

Install instructions for Ubuntu

Requirements

  • Ubuntu 16.04 64-bit or newer
  • Root access via SSH

Quick install

Recommended for new Linux users

Run the following command:

sudo su -c "bash <(wget -qO- https://cubecoders.com/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 ampinstmgr -b")| crontab -

Updating AMP

Updating the instance manager

apt update
apt upgrade

Updating the AMP instances

ampinstmgr upgradeall

 

Install instructions for Debian

Requirements

  • Debian 8 64-bit or newer
  • Root access via SSH

Quick install

Recommended for new Linux users

Run the following command:

sudo su -c "bash <(wget -qO- https://cubecoders.com/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 iptables-persistent
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

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

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 ampinstmgr -b")| crontab -

Updating AMP

Updating the instance manager

apt update
apt upgrade

Updating the AMP instances

ampinstmgr upgradeall

 

Install instructions for CentOS

Requirements

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

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
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

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 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

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

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/ampisntmgr /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 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

ampinstmgr upgradeall

 

Install instructions for Windows

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!)

Note: Windows Server Nano/Core is not supported. Support for Windows Server Core will be available soon, Nano cannot be supported as many application servers do not run on it.

Create a new user to run AMP as

While this step is not strictly mandatory, failure to do so can result in permissions issues that can cause AMP to stop working properly.
AMP will not run as the built in Administrator user on Windows.

  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

Click this button >> Download for Windows and run through the wizard

When you are prompted for the AMP Datastore location, you must pick a location that is outside of the Users area. If the datastore is located in the Users area it will frequently cause permissions issues (especially if you didn't follow the recommended steps above and are running as Administrator)

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 maange 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.

 

Decoration