Skip to content

Fix to the linux navigation #30894

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Aug 6, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions config/_default/menus/main.en.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -316,7 +316,7 @@ menu:
parent: basic_agent_usage
- name: Alma Linux
identifier: basic_agent_usage_alma_linux
url: agent/basic_agent_usage/centos/
url: agent/basic_agent_usage/alma/
weight: 103
parent: basic_agent_usage
- name: Ansible
Expand Down Expand Up @@ -371,7 +371,7 @@ menu:
parent: basic_agent_usage
- name: Rocky Linux
identifier: basic_agent_usage_rockylinux
url: agent/basic_agent_usage/centos/
url: agent/basic_agent_usage/rocky/
weight: 114
parent: basic_agent_usage
- name: SaltStack
Expand Down
26 changes: 26 additions & 0 deletions content/en/agent/basic_agent_usage/alma.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
title: Basic Agent Usage for Alma Linux
platform: Alma Linux
aliases:
- /guides/basic_agent_usage/centos/
further_reading:
- link: "/logs/"
tag: "Documentation"
text: "Collect your logs"
- link: "/infrastructure/process/"
tag: "Documentation"
text: "Collect your processes"
- link: "/tracing/"
tag: "Documentation"
text: "Collect your traces"
- link: "/agent/basic_agent_usage/#agent-architecture"
tag: "Documentation"
text: "Find out more about the Agent's architecture"
- link: "/agent/configuration/network#configure-ports"
tag: "Documentation"
text: "Configure inbound ports"
algolia:
tags: ['uninstall', 'uninstalling']
---

{{< include-markdown "/agent/basic_agent_usage/amazonlinux" >}}
100 changes: 2 additions & 98 deletions content/en/agent/basic_agent_usage/centos.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: Basic Agent Usage for CentOS, Rocky, and Alma Linux
title: Basic Agent Usage for CentOS
platform: CentOS
aliases:
- /guides/basic_agent_usage/centos/
Expand All @@ -23,100 +23,4 @@ algolia:
tags: ['uninstall', 'uninstalling']
---

## Overview

This page outlines the basic features of the Datadog Agent for CentOS and its derivatives, Rocky Linux and Alma Linux. To install the Datadog Agent, follow the [Agent Installation Instructions][1] for CentOS.

Packages are available for 64-bit x86 and Arm v8 architectures. For other architectures, use the source install.

**Note**: CentOS 6 and above are supported on the 64-bit x86 architecture. CentOS/Rocky/Alma 8 and above are supported on the 64-bit Arm v8 architecture.

## Commands

In Agent v6 and v7, the service manager provided by the operating system is responsible for the Agent lifecycle, while other commands must be run through the Agent binary directly. In Agent v5, almost everything is done through the service manager.

### CentOS 7 and higher

| Description | Command |
|------------------------------------|--------------------------------------------------------|
| Start Agent as a service | `sudo systemctl start datadog-agent` |
| Stop Agent running as a service | `sudo systemctl stop datadog-agent` |
| Restart Agent running as a service | `sudo systemctl restart datadog-agent` |
| Status of Agent service | `sudo systemctl status datadog-agent` |
| Status page of running Agent | `sudo datadog-agent status` |
| Send flare | `sudo datadog-agent flare` |
| Display command usage | `sudo datadog-agent --help` |
| Run a check | `sudo -u dd-agent -- datadog-agent check <CHECK_NAME>` |

### CentOS 6

| Description | Command |
|------------------------------------|--------------------------------------------------------|
| Start Agent as a service | `sudo start datadog-agent` |
| Stop Agent running as a service | `sudo stop datadog-agent` |
| Restart Agent running as a service | `sudo restart datadog-agent` |
| Status of Agent service | `sudo status datadog-agent` |
| Status page of running Agent | `sudo datadog-agent status` |
| Send flare | `sudo datadog-agent flare` |
| Display command usage | `sudo datadog-agent --help` |
| Run a check | `sudo -u dd-agent -- datadog-agent check <CHECK_NAME>` |

**Note**: If the `service` wrapper is not available on your system, use:

* On `upstart`-based systems: `sudo start/stop/restart/status datadog-agent`
* On `systemd`-based systems: `sudo systemctl start/stop/restart/status datadog-agent`

## Configuration

The configuration files and folders for the Agent are located in:

* `/etc/datadog-agent/datadog.yaml`

Configuration files for [Integrations][4]:

* `/etc/datadog-agent/conf.d/`

## Uninstall the Agent

To uninstall the Agent, run the following command:

```shell
sudo yum remove datadog-agent
```

This command removes the Agent, but does not remove:
* The `datadog.yaml` configuration file
* User-created files in the `/etc/datadog-agent` configuration folder
* User-created files in the `/opt/datadog-agent` folder
* The `dd-agent` user
* Datadog log files

If you also want to remove these elements, run this command after removing the Agent:

```shell
sudo userdel dd-agent \
&& sudo rm -rf /opt/datadog-agent/ \
&& sudo rm -rf /etc/datadog-agent/ \
&& sudo rm -rf /var/log/datadog/
```

{{% apm-ssi-uninstall-linux %}}

## Troubleshooting

See the [Agent Troubleshooting documentation][2].

## Working with the embedded Agent

The Agent contains an embedded Python environment at `/opt/datadog-agent/embedded/`. Common binaries such as `python` and `pip` are contained within `/opt/datadog-agent/embedded/bin/`.

See the instructions on how to [add packages to the embedded Agent][3] for more information.

## Further Reading

{{< partial name="whats-next/whats-next.html" >}}

[1]: https://app.datadoghq.com/account/settings/agent/latest?platform=centos
[2]: /agent/troubleshooting/
[3]: /developers/guide/custom-python-package/
[4]: /integrations/
{{< include-markdown "/agent/basic_agent_usage/amazonlinux" >}}
85 changes: 1 addition & 84 deletions content/en/agent/basic_agent_usage/deb.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,87 +25,4 @@ algolia:
tags: ['uninstall', 'uninstalling']
---

## Overview

This page outlines the basic features of the Datadog Agent for Debian. If you haven't installed the Agent yet, instructions can be found in the [Datadog Agent Integration][1] documentation.

Packages are available for 64-bit x86 and Arm v8 architectures. For other architectures, use the source install.

**Notes**:
- On the 64-bit x86 architecture, Debian 7 (wheezy) and above are supported in Agent < 6.36.0/7.36.0. Debian 8 (jessie) and above are supported in Agent >= 6.36.0/7.36.0. SysVinit is supported in Agent v6.6.0+.
- On the 64-bit Arm v8 architecture, Debian 9 (stretch) and above are supported.

## Commands

In Agent v6 and v7, the service manager provided by the operating system is responsible for the Agent lifecycle, while other commands must be run through the Agent binary directly. In Agent v5, almost everything is done through the service manager.

| Description | Command |
|------------------------------------|--------------------------------------------------------|
| Start Agent as a service | `sudo service datadog-agent start` |
| Stop Agent running as a service | `sudo service datadog-agent stop` |
| Restart Agent running as a service | `sudo service datadog-agent restart` |
| Status of Agent service | `sudo service datadog-agent status` |
| Status page of running Agent | `sudo datadog-agent status` |
| Send flare | `sudo datadog-agent flare` |
| Display command usage | `sudo datadog-agent --help` |
| Run a check | `sudo -u dd-agent -- datadog-agent check <CHECK_NAME>` |

**Note**: If the `service` wrapper is not available on your system, use:

* On `upstart`-based systems: `sudo start/stop/restart/status datadog-agent`
* On `systemd`-based systems: `sudo systemctl start/stop/restart/status datadog-agent`

## Configuration

The configuration files and folders for the Agent are located in:

* `/etc/datadog-agent/datadog.yaml`

Configuration files for [Integrations][5]:

* `/etc/datadog-agent/conf.d/`

## Uninstall the Agent

To uninstall the Agent, run the following command:

```shell
sudo apt-get remove datadog-agent -y
```

This command removes the Agent, but does not remove:

* The `datadog.yaml` configuration file
* User-created files in the `/etc/datadog-agent` configuration folder
* User-created files in the `/opt/datadog-agent` folder
* The `dd-agent` user
* Datadog log files

If you also want to remove these elements, run this command after removing the Agent:

```shell
sudo apt-get remove --purge datadog-agent -y
```


{{% apm-ssi-uninstall-linux %}}

## Troubleshooting

See the [Agent Troubleshooting documentation][3].

## Working with the embedded Agent

The Agent contains an embedded Python environment at `/opt/datadog-agent/embedded/`. Common binaries such as `python` and `pip` are contained within `/opt/datadog-agent/embedded/bin/`.

See the instructions on how to [add packages to the embedded Agent][4] for more information.

## Further Reading

{{< partial name="whats-next/whats-next.html" >}}

[1]: https://app.datadoghq.com/account/settings/agent/latest?platform=debian
[2]: /agent/faq/agent-v6-changes/?tab=linux#service-lifecycle-commands
[3]: /agent/troubleshooting/
[4]: /developers/guide/custom-python-package/
[5]: /integrations/
{{< include-markdown "/agent/basic_agent_usage/amazonlinux" >}}
83 changes: 1 addition & 82 deletions content/en/agent/basic_agent_usage/fedora.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,85 +23,4 @@ algolia:
tags: ['uninstall', 'uninstalling']
---

## Overview

This page outlines the basic features of the Datadog Agent for Fedora. If you haven't installed the Agent yet, instructions can be found in the [Datadog Agent Integration][1] documentation.

Packages are available for 64-bit x86 and Arm v8 architectures. For other architectures, use the source install.

**Note**: Fedora 26 and above are supported on the 64-bit x86 architecture. Fedora 27 and above are supported on the 64-bit Arm v8 architecture.

## Commands

In Agent v6 and v7, the service manager provided by the operating system is responsible for the Agent lifecycle, while other commands must be run through the Agent binary directly. In Agent v5, almost everything is done through the service manager.

| Description | Command |
|------------------------------------|--------------------------------------------------------|
| Start Agent as a service | `sudo systemctl start datadog-agent` |
| Stop Agent running as a service | `sudo systemctl stop datadog-agent` |
| Restart Agent running as a service | `sudo systemctl restart datadog-agent` |
| Status of Agent service | `sudo systemctl status datadog-agent` |
| Status page of running Agent | `sudo datadog-agent status` |
| Send flare | `sudo datadog-agent flare` |
| Display command usage | `sudo datadog-agent --help` |
| Run a check | `sudo -u dd-agent -- datadog-agent check <CHECK_NAME>` |

**Note**: If the `service` wrapper is not available on your system, use:

* On `upstart`-based systems: `sudo start/stop/restart/status datadog-agent`
* On `systemd`-based systems: `sudo systemctl start/stop/restart/status datadog-agent`

## Configuration

The configuration files and folders for the Agent are located in:

* `/etc/datadog-agent/datadog.yaml`

Configuration files for [Integrations][4]:

* `/etc/datadog-agent/conf.d/`

## Uninstall the Agent

To uninstall the Agent, run the following command:

```shell
sudo yum remove datadog-agent
```

This command removes the Agent, but does not remove:
* The `datadog.yaml` configuration file
* User-created files in the `/etc/datadog-agent` configuration folder
* User-created files in the `/opt/datadog-agent` folder
* The `dd-agent` user
* Datadog log files

If you also want to remove these elements, run this command after removing the Agent:

```shell
sudo userdel dd-agent \
&& sudo rm -rf /opt/datadog-agent/ \
&& sudo rm -rf /etc/datadog-agent/ \
&& sudo rm -rf /var/log/datadog/
```

{{% apm-ssi-uninstall-linux %}}

## Troubleshooting

See the [Agent Troubleshooting documentation][2].

## Working with the embedded Agent

The Agent contains an embedded Python environment at `/opt/datadog-agent/embedded/`. Common binaries such as `python` and `pip` are contained within `/opt/datadog-agent/embedded/bin/`.

See the instructions on how to [add packages to the embedded Agent][3] for more information.

## Further Reading

{{< partial name="whats-next/whats-next.html" >}}

[1]: https://app.datadoghq.com/account/settings/agent/latest?platform=fedora
[2]: /agent/troubleshooting/
[3]: /developers/guide/custom-python-package/
[4]: /integrations/
{{< include-markdown "/agent/basic_agent_usage/amazonlinux" >}}
Loading
Loading