PHP Agent Installation - Ubuntu and Debian

Install the agent

Add repository and gpg key

Execute the following command to add the gpg key.

copy

curl https://s3.amazonaws.com/atatus-artifacts/gpg/atatus-sha512.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/atatus-sha512.gpg

Execute the following command to add the debian repository.

copy

echo "deb https://s3.amazonaws.com/atatus-artifacts/atatus-php/debian stable main" | sudo tee -a /etc/apt/sources.list.d/atatus-php-agent.list

Install php agent

copy
```
sudo apt-get update
```
copy
```
sudo ATATUS_LICENSE_KEY="APM_LIC_KEY" ATATUS_APP_NAME="YOUR_APP_NAME" apt-get install atatus-php-agent -y
```
APM_LIC_KEY - add the Atatus APM License key in this line of code.

YOUR_APP_NAME - add the application name in this line of code.
Restart your web server and PHP - FPM

Stop and Start your servers such as nginx, php-fpm, apache, httpd, etc. Then you will see the performance data in a few minutes.

Just access your server from your web app or mobile app or curl. You will visualize your application's metrics within minutes.

# Verify package installed
rpm -qa | grep atatus-php-agent

# Verify PHP extension loaded
php -i | grep atatus

No data appears in the Atatus dashboard? Refer to the Troubleshooting Guide for help.

Upgrade the agent (to the next version)

Execute the following command to upgrade to the latest version.

copy

sudo apt-get update

copy

apt policy atatus-php-agent
sudo apt-get install --only-upgrade atatus-php-agent

Install specific version of agent

Remove Atatus agent completely.

sudo apt-get purge atatus-php-agent

Check list of available Atatus versions.

apt policy atatus-php-agent

(or)

apt-cache policy atatus-php-agent

# Sample output for apt-cache policy

atatus-php-agent:
  Installed: 1.18.0-1
  Candidate: 1.18.0-1
  Version table:
 *** 1.18.0-1 500
        500 https://s3.amazonaws.com/atatus-artifacts/atatus-php/debian stable/main amd64 Packages
        100 /var/lib/dpkg/status

In above output you can see the version as 1.18.0-1. Keep in mind that the version number always ends with suffix like -1.

Install specific version of Atatus agent.

sudo ATATUS_LICENSE_KEY="APM_LIC_KEY" ATATUS_APP_NAME="YOUR_APP_NAME" apt-get install atatus-php-agent="SPECIFIC_VERSION" -y

# Install specific version 1.18.0
sudo ATATUS_LICENSE_KEY="APM_LIC_KEY" ATATUS_APP_NAME="YOUR_APP_NAME" apt-get install atatus-php-agent="1.18.0-1" -y

For Ubuntu 20.04 and below

In Ubuntu 20.04 and below, you can use apt-key add to add third-party GPG keys. Use the commands below to add the Atatus GPG keys:

copy

curl https://s3.amazonaws.com/atatus-artifacts/gpg/atatus-sha512.gpg | sudo apt-key add -