Skip to content

Commit d63f943

Browse files
authored
Merge pull request #5565 from paulinbar/painbar-rollback-linux-install
Painbar rollback linux install
2 parents fbfad24 + 08bd18f commit d63f943

File tree

5 files changed

+377
-142
lines changed

5 files changed

+377
-142
lines changed

.openpublishing.redirection.defender-endpoint.json

Lines changed: 3 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -166,14 +166,9 @@
166166
"redirect_document_id": false
167167
},
168168
{
169-
"source_path": "defender-endpoint/microsoft-defender-endpoint-linux.md",
170-
"redirect_url": "/defender-endpoint/install-defender-endpoint-linux",
169+
"source_path": "defender-endpoint/install-defender-endpoint-linux.md",
170+
"redirect_url": "/defender-endpoint/mde-linux-prerequisites",
171171
"redirect_document_id": false
172-
},
173-
{
174-
"source_path": "defender-endpoint/mde-linux-prerequisites.md",
175-
"redirect_url": "/defender-endpoint/install-defender-endpoint-linux#prerequisites",
176-
"redirect_document_id": false
177-
}
172+
}
178173
]
179174
}

defender-endpoint/TOC.yml

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,8 @@
1212
href: microsoft-defender-endpoint.md
1313
- name: Defender for Endpoint on macOS
1414
href: microsoft-defender-endpoint-mac.md
15+
- name: Defender for Endpoint on Linux
16+
href: microsoft-defender-endpoint-linux.md
1517
- name: Defender for Endpoint on Android
1618
href: microsoft-defender-endpoint-android.md
1719
- name: Defender for Endpoint on iOS
@@ -259,8 +261,8 @@
259261
items:
260262
- name: Deploy Defender for Endpoint on Linux
261263
items:
262-
- name: Install Defender for Endpoint on Linux
263-
href: install-defender-endpoint-linux.md
264+
- name: Prerequisites
265+
href: mde-linux-prerequisites.md
264266
- name: Choose a deployment method
265267
items:
266268
- name: Enabling deployment to a custom location

defender-endpoint/install-defender-endpoint-linux.md

Lines changed: 0 additions & 132 deletions
This file was deleted.
Lines changed: 223 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,223 @@
1+
---
2+
title: Prerequisites for Microsoft Defender for Endpoint on Linux
3+
ms.reviewer: gopkr, pahuijbr, megphapriya
4+
description: Describes the requirements needed to install and use Microsoft Defender for Endpoint on Linux.
5+
ms.service: defender-endpoint
6+
ms.author: painbar
7+
author: paulinbar
8+
ms.localizationpriority: medium
9+
manager: bagol
10+
audience: ITPro
11+
ms.collection:
12+
- m365-security
13+
- tier3
14+
- mde-linux
15+
ms.topic: conceptual
16+
ms.subservice: linux
17+
search.appverid: met150
18+
ms.date: 11/11/2025
19+
---
20+
21+
# Prerequisites for Microsoft Defender for Endpoint on Linux
22+
23+
> [!TIP]
24+
> Microsoft Defender for Endpoint on Linux now extends support for Arm64-based Linux servers in GA.
25+
26+
This article lists hardware and software requirements for Defender for Endpoint on Linux. For more information about Defender for Endpoint on Linux, such as what's included in this offering, see the following articles:
27+
28+
- [Defender for Endpoint on Linux](microsoft-defender-endpoint-linux.md)
29+
30+
- [What's new in Defender for Endpoint on Linux](linux-whatsnew.md)
31+
32+
[!INCLUDE [side-by-side-scenarios](includes/side-by-side-scenarios.md)]
33+
34+
## License requirements
35+
36+
To onboard servers to Defender for Endpoint, server licenses are required. You can choose from the following options:
37+
38+
- Microsoft Defender for Servers Plan 1 or Plan 2
39+
- Microsoft Defender for Endpoint for servers
40+
- [Microsoft Defender for Business servers](/defender-business/get-defender-business?tabs=findpartner#how-to-get-microsoft-defender-for-business-servers) (for small and medium-sized businesses only)
41+
42+
For more detailed information about licensing requirements for Microsoft Defender for Endpoint, see [Microsoft Defender for Endpoint licensing information](/office365/servicedescriptions/microsoft-365-service-descriptions/microsoft-365-tenantlevel-services-licensing-guidance/microsoft-365-security-compliance-licensing-guidance#microsoft-defender-for-endpoint).
43+
44+
For detailed licensing information, see [Product Terms: Microsoft Defender for Endpoint]( https://www.microsoft.com/licensing/terms/productoffering/MicrosoftDefenderforEndpoint/EAEAS) and work with your account team to learn more about the terms and conditions.
45+
46+
## System requirements
47+
48+
- **CPU**: One CPU core minimum. For high-performance workloads, more cores are recommended.
49+
- **Disk Space**: 2 GB minimum. For high-performance workloads, more disk space might be needed.
50+
- **Memory**: 1 GB of RAM minimum. For high-performance workloads, more memory might be needed.
51+
- For installation at a custom path, refer to [Prerequisites and system requirements for custom location installation](linux-custom-location-installation.md#prerequisites-and-system-requirements).
52+
53+
> [!NOTE]
54+
> Performance tuning might be needed based on workloads. For more information, see [Performance tuning for Microsoft Defender for Endpoint on Linux](/defender-endpoint/linux-support-perf)
55+
56+
## Software requirements
57+
58+
- Linux server endpoints should be able to access the `*.endpoint.security.microsoft.com`. If necessary, [configure static proxy discovery](linux-static-proxy-configuration.md).
59+
- Linux server endpoints should have systemd (system manager) installed.
60+
- Administrative privileges on the Linux server endpoint are required for installation.
61+
- An appropriate role assigned in Defender for Endpoint. See [Role-based access control](/defender-endpoint/prepare-deployment#role-based-access-control).
62+
63+
> [!NOTE]
64+
> Linux distributions using system manager support both SystemV and Upstart.
65+
> The Microsoft Defender for Endpoint on Linux agent is independent from [Operation Management Suite (OMS) agent](/azure/azure-monitor/agents/azure-monitor-agent-overview#log-analytics-agent).
66+
> Microsoft Defender for Endpoint relies on its own independent telemetry pipeline.
67+
68+
## Supported Linux distributions
69+
70+
The following Linux server distributions and x64 (AMD64/EM64T) versions are supported:
71+
72+
- Red Hat Enterprise Linux 7.2 and higher
73+
- Red Hat Enterprise Linux 8.x
74+
- Red Hat Enterprise Linux 9.x
75+
- Red Hat Enterprise Linux 10.x
76+
- CentOS 7.2 and higher, excluding CentOS Stream
77+
- CentOS 8.x
78+
- Ubuntu 16.04 LTS
79+
- Ubuntu 18.04 LTS
80+
- Ubuntu 20.04 LTS
81+
- Ubuntu 22.04 LTS
82+
- Ubuntu 24.04 LTS
83+
- Debian 9 - 12
84+
- SUSE Linux Enterprise Server 12.x
85+
- SUSE Linux Enterprise Server 15.x
86+
- Oracle Linux 7.2 and higher
87+
- Oracle Linux 8.x
88+
- Oracle Linux 9.x
89+
- Amazon Linux 2
90+
- Amazon Linux 2023
91+
- Fedora 33-42
92+
- Rocky 8.7 and higher
93+
- Rocky 9.2 and higher
94+
- Alma 8.4 and higher
95+
- Alma 9.2 and higher
96+
- Mariner 2
97+
98+
**The following Linux server distributions on ARM64 are now GA:**
99+
100+
- Ubuntu 20.04 ARM64
101+
- Ubuntu 22.04 ARM64
102+
- Ubuntu 24.04 ARM64
103+
- Debian 11, 12 ARM64
104+
- Amazon Linux 2 ARM64
105+
- Amazon Linux 2023 ARM64
106+
- RHEL 8.x ARM64
107+
- RHEL 9.x ARM64
108+
- RHEL 10.x ARM64
109+
- Oracle Linux 8.x ARM64
110+
- Oracle Linux 9.x ARM64
111+
- SUSE Linux Enterprise Server 15 (SP5, SP6) ARM64
112+
113+
> [!NOTE]
114+
> Distributions and versions that aren't explicitly listed above, and custom operating systems, are unsupported (even if they're derived from the officially supported distributions).
115+
> Microsoft Defender for Endpoint is kernel-version agnostic for all other supported distributions and versions. The minimal requirement for the kernel version is `3.10.0-327` or later.
116+
117+
> [!WARNING]
118+
> Running Defender for Endpoint on Linux alongside other fanotify-based security solutions is not supported and may lead to unpredictable behavior, including system hangs.
119+
> If any applications use fanotify in blocking mode, they will appear in the conflicting_applications field of the mdatp health command output.
120+
> You can still safely take advantage of Defender for Endpoint on Linux by setting antivirus enforcement level to passive. See [Configure security settings in Microsoft Defender for Endpoint on Linux](/defender-endpoint/linux-preferences).> **EXCEPTION:** The Linux `FAPolicyD` feature, which also uses Fanotify in blocking mode, is supported with Defender for Endpoint in active mode on RHEL and Fedora platforms, provided that mdatp health reports a healthy status. This exception is based on validated compatibility specific to these distributions.
121+
>
122+
>
123+
124+
## Supported filesystems for real-time protection and quick, full, and custom scans
125+
126+
|Real-time protection and quick/full scans|Custom scans|
127+
|---|---|
128+
|`btrfs`|All filesystems are supported for real-time protection and quick/full scans|
129+
|`ecryptfs`|`Efs`|
130+
|`ext2`|`S3fs`|
131+
|`ext3`|`Blobfuse`|
132+
|`ext4`|`Lustr`|
133+
|`fuse`|`glustrefs`|
134+
|`fuseblk`|`Afs`|
135+
|`jfs`|`sshfs`|
136+
|`nfs` (v3 only)|`cifs`|
137+
|`overlay`|`smb`|
138+
|`ramfs`|`gcsfuse`|
139+
|`reiserfs`|`sysfs`|
140+
|`tmpfs`|
141+
|`udf`|
142+
|`vfat`|
143+
|`xfs`|
144+
145+
> [!NOTE]
146+
> To scan NFS v3 mount points, make sure to set the `no_root_squash` export option. Without this option, scanning NFS v3 can potentially fail due to lack of permissions.
147+
148+
## Verify if devices can connect to Defender for Endpoint cloud services
149+
150+
1. Prepare your environment, as described in Step 1 of the following article [Configure your network environment to ensure connectivity with Defender for Endpoint service](/defender-endpoint/configure-environment).
151+
152+
2. Connect Defender for Endpoint on Linux through a proxy server by using the following discovery methods:
153+
154+
- Transparent proxy
155+
- [Manual static proxy configuration](/defender-endpoint/linux-static-proxy-configuration#installation-time-configuration)
156+
157+
3. Permit anonymous traffic in the previously listed URLs, if a proxy or firewall blocks traffic.
158+
159+
> [!NOTE]
160+
> Configuration for transparent proxies isn't needed for Defender for Endpoint. See [Manual Static Proxy Configuration.](/defender-endpoint/linux-static-proxy-configuration)
161+
162+
> [!WARNING]
163+
> PAC, WPAD, and authenticated proxies aren't supported.
164+
> Use only static or transparent proxies.
165+
> SSL inspection and intercepting proxies aren't supported for security reasons.
166+
> Configure an exception for SSL inspection and your proxy server to allow direct data pass-through from Defender for Endpoint on Linux to the relevant URLs without interception.
167+
> Adding your interception certificate to the global store doesn't enable interception.
168+
169+
For troubleshooting steps, see [Troubleshoot cloud connectivity issues for Microsoft Defender for Endpoint on Linux](/defender-endpoint/linux-support-connectivity)
170+
171+
## External package dependency
172+
173+
If the Microsoft Defender for Endpoint installation fails due to missing dependencies errors, you can manually download the prerequisite dependencies. The following external package dependencies exist for the mdatp package:
174+
175+
- The mdatp RPM package requires `glibc >= 2.17`.
176+
- For DEBIAN the mdatp package requires `libc6 >= 2.23`.
177+
178+
> [!NOTE]
179+
> For versions 101.25042.0003 and later, no external dependencies are required, whereas versions older than 101.25032.0000 require additional packages:
180+
> - RPM-based distributions: `mde-netfilter`, `pcre`, `libmnl`, `libnfnetlink`, `libnetfilter_queue`, `glib2`
181+
> - DEBIAN-based distributions: `mde-netfilter`, `libpcre3`, `libnetfilter-queue1`, `libglib2.0-0`
182+
> Beginning with version `101.24082.0004`, Defender for Endpoint on Linux no longer supports the `Auditd` event provider. We're transitioning completely to the more efficient eBPF technology.
183+
> If eBPF isn't supported on your machines, or if there are specific requirements to remain on Auditd, and your machines are using Defender for Endpoint on Linux version `101.24072.0001` or older, the following additional dependency on the auditd package exists for mdatp:
184+
> - The mdatp RPM package requires `audit`, `semanage`.
185+
> - For DEBIAN, the mdatp package requires `auditd`.
186+
> - For Mariner, the mdatp package requires `audit`.
187+
188+
## Installation instructions
189+
190+
There are several methods and tools that you can use to deploy Microsoft Defender for Endpoint on Linux (applicable to AMD64 and ARM64 Linux servers):
191+
192+
- [Installer script based deployment](/defender-endpoint/linux-installer-script)
193+
- [Ansible based deployment](/defender-endpoint/linux-install-with-ansible)
194+
- [Chef based deployment](/defender-endpoint/linux-deploy-defender-for-endpoint-with-chef)
195+
- [Puppet based deployment](/defender-endpoint/linux-install-with-puppet)
196+
- [SaltStack based deployment](/defender-endpoint/linux-install-with-saltack)
197+
- [Manual deployment](/defender-endpoint/linux-install-manually)
198+
- [Direct onboarding with Defender for Cloud](/azure/defender-for-cloud/onboard-machines-with-defender-for-endpoint)
199+
- [Guidance for Defender for Endpoint on Linux Server with SAP](/defender-endpoint/mde-linux-deployment-on-sap)
200+
201+
> [!IMPORTANT]
202+
> On Linux, Microsoft Defender for Endpoint creates an mdatp user with random UID and GID values. If you want to control these values, create an mdatp user before installation using the `/usr/sbin/nologin` shell option. Here's an example: `mdatp:x:UID:GID::/home/mdatp:/usr/sbin/nologin`.
203+
204+
If you experience any installation issues, self-troubleshooting resources are available. See the links in the [Related content section](#related-content).
205+
206+
## Next steps
207+
208+
- [Deploy Defender for Endpoint on Linux](/defender-endpoint/linux-installer-script)
209+
- [Configure Defender for Endpoint on Linux](/defender-endpoint/linux-preferences)
210+
- [Deploy updates for Defender for Endpoint on Linux](/defender-endpoint/linux-updates)
211+
212+
## Related content
213+
214+
- [Use Microsoft Defender for Endpoint Security Settings Management to manage Microsoft Defender Antivirus](mde-security-settings-management.md)
215+
- [Linux Resources](linux-resources.md)
216+
- [Troubleshoot cloud connectivity issues for Microsoft Defender for Endpoint on Linux](linux-support-connectivity.md)
217+
- [Investigate agent health issues](health-status.md)
218+
- [Troubleshoot missing events or alerts issues for Microsoft Defender for Endpoint on Linux](linux-support-events.md)
219+
- [Troubleshoot performance issues for Microsoft Defender for Endpoint on Linux](linux-support-perf.md)
220+
- [Install Defender for Endpoint on Linux to a custom path](linux-custom-location-installation.md)
221+
222+
> [!TIP]
223+
> Do you want to learn more? Engage with the Microsoft Security community in our Tech Community: [Microsoft Defender for Endpoint Tech Community](https://techcommunity.microsoft.com/category/microsoft-defender-for-endpoint/discussions/microsoftdefenderatp)

0 commit comments

Comments
 (0)