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.gpg | sudo apt-key add -

copy

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

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.
Stop and Start your PHP services.

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.

No data appear in Atatus dashboard: Refer Troubleshooting Guide.

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.16.0-1
  Candidate: 1.16.0-1
  Version table:
 *** 1.16.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.16.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.16.0
sudo ATATUS_LICENSE_KEY="APM_LIC_KEY" ATATUS_APP_NAME="YOUR_APP_NAME" apt-get install atatus-php-agent="1.16.0-1" -y

For Ubuntu 22.04 and above

With Ubuntu 22.04 and higher, the apt-key has been deprecated because it allows the system to accept signatures from third-party keyholders that don't have a signed-by option. So please use the below steps instead of apt-key add in Ubuntu 22.04+

copy

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