Install SSM Agent on Ubuntu Server 16.04 and 14.04 64-bit (deb) - Amazon Systems Manager
Quick installation commands for SSM Agent on Ubuntu Server 16.04 and 14.04 64-bit (deb)Create custom installation commands for SSM Agent on Ubuntu Server 16.04 and 14.04 64-bit (deb) in your Region
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Install SSM Agent on Ubuntu Server 16.04 and 14.04 64-bit (deb)

Important

Before you install SSM Agent on a 64-bit version of Ubuntu Server, ensure that you are using the correction installation tools. Beginning with Amazon Machine Images (AMIs) that are identified with 20180627, SSM Agent is pre-installed on version 16.04 using Snap packages. On instances created from earlier AMIs, SSM Agent must be installed using deb installer packages. For more information, see Determining the correct SSM Agent version to install on 64-bit Ubuntu Server 16.04 instances.If SSM Agent is installed on your instance in conjunction with a Snap and you install or update SSM Agent using a deb installer package, the installation or SSM Agent operations might fail.

In most cases, the Amazon Machine Images (AMIs) Ubuntu Server 16.04 that are provided by Amazon come with Amazon Systems Manager Agent (SSM Agent) preinstalled by default. For more information, see Amazon Machine Images (AMIs) with SSM Agent preinstalled.

In the event that SSM Agent isn’t preinstalled on a new Ubuntu Server 16.04 instance prior to version 20180627, you are installing on Ubuntu Server 14.04, or you need to manually reinstall the agent, use the information on this page to help you.

Quick installation commands for SSM Agent on Ubuntu Server 16.04 and 14.04 64-bit (deb)

Use the following steps to manually install SSM Agent on a single instance. This procedure uses globally available installation files.

To install SSM Agent on Ubuntu Server 16.04 and 14.04 64-bit (deb) using quick copy and paste commands

  1. Connect to your Ubuntu Server instance using your preferred method, such as SSH.

  2. Run the following command to create a temporary directory on the instance.

    mkdir /tmp/ssm

  3. Change to the temporary directory.

    cd /tmp/ssm

  4. Run the following commands.

    Note

    Even though URLs in the following commands include an ec2-downloads-windows directory, these are the correct global installation files for Ubuntu Server 16.04 and 14.04 64-bit. 

    wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_amd64/amazon-ssm-agent.deb
    sudo dpkg -i amazon-ssm-agent.deb

  5. (Recommended) Run one of the following commands to determine if SSM Agent is running.

    Ubuntu Server 16.04
    sudo systemctl status amazon-ssm-agent
    Ubuntu Server 14.04
    sudo status amazon-ssm-agent

    In most cases, the command reports that the agent is running.

    In rare cases, the command reports that the agent is installed but not running, as shown in the following example.

  6. Run one of the following commands to start the service if the previous command returned amazon-ssm-agent is stopped, inactive, or disabled.

    Ubuntu Server 16.04:

    sudo systemctl enable amazon-ssm-agent

    Ubuntu Server 14.04:

    sudo start amazon-ssm-agent

Create custom installation commands for SSM Agent on Ubuntu Server 16.04 and 14.04 64-bit (deb) in your Region

When you install SSM Agent on multiple instances using a script or template, we recommended using installation files that are stored in the Amazon Web Services Region you're working in.

For the following commands, we provide examples that use a publicly accessible S3 bucket in the US East (Ohio) Region (us-east-2).

Tip

You can also replace a global URL in the procedure Quick installation commands for SSM Agent on Ubuntu Server 16.04 and 14.04 64-bit (deb) earlier in this topic with a custom Regional URL you construct.

In the following command, replace region with your own information. For a list of supported region values, see the Region column in Systems Manager service endpoints in the Amazon Web Services General Reference.

wget https://s3.region.amazonaws.com/amazon-ssm-region/latest/debian_amd64/amazon-ssm-agent.deb
sudo dpkg -i amazon-ssm-agent.deb

See the following example.

wget https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/debian_amd64/amazon-ssm-agent.deb
sudo dpkg -i amazon-ssm-agent.deb