> ## Documentation Index
> Fetch the complete documentation index at: https://jetemail.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# DirectAdmin Plugin

> Install and set up the JetEmail plugin for DirectAdmin servers

> **Warning:** This plugin only supports AlmaLinux, Rocky Linux, and CloudLinux operating systems. Ubuntu and Debian are not yet supported.

## Installing the DirectAdmin Plugin

To install our DirectAdmin plugin, follow these steps:

1. Ensure you have root access to your DirectAdmin server.

2. Generate a smarthost (or use an existing one) in your JetEmail [dashboard.](/outbound/getting-started)

3. Open a terminal or SSH into your server.

4. Download the installation script and set the correct permissions:

```bash theme={null}
curl -O https://cdn.jetemail.com/plugins/directadmin/install-directadmin.sh
chmod 755 install-directadmin.sh
```

5. Run the installation script (no inputs required):

```bash theme={null}
./install-directadmin.sh
```

6. The script will install the JetEmail repository on your server.

7. After the repository is installed, you have two options to complete the configuration:

   **Option A: Command Line Installation**

   Run the `jetemail-directadmin` command with your JetEmail credentials:

   ```bash theme={null}
   jetemail-directadmin --smtp-user USERNAME --smtp-pass PASSWORD
   ```

   Available options:

   * `-u, --smtp-user <SMTP_USER>`: Your JetEmail smarthost username (required, must not contain @ symbol)
   * `-p, --smtp-pass <SMTP_PASS>`: Your JetEmail smarthost password (required)
   * `-d, --domain-lockdown`: Add DNS TXT records for all domains ([Domain Lockdown](/outbound/domain-lockdown))
   * `-s, --add-spf`: Add SPF include for JetEmail ([email authentication](/outbound/email-authentication))
   * `-v, --verbose`: Verbose output (use multiple times for more verbosity)
   * `--skip-smtp-test`: Skip SMTP connection test (use if network restrictions prevent connection testing)
   * `--test-only`: Test mode: only test SMTP connection, don't install anything
   * `-h, --help`: Print help

   Examples:

   ```bash theme={null}
   # Basic installation
   jetemail-directadmin -u smarthostusername -p password

   # With domain lockdown
   jetemail-directadmin -u smarthostusername -p password -d

   # With SPF modification
   jetemail-directadmin -u smarthostusername -p password -s

   # With both domain lockdown and SPF
   jetemail-directadmin -u smarthostusername -p password -d -s

   # Test SMTP connection only
   jetemail-directadmin -u smarthostusername -p password --test-only
   ```

   **Option B: DirectAdmin Plugin**

   Use the JetEmail plugin in DirectAdmin to complete the configuration through the web interface. The plugin is located at Extra Features -> JetEmail SMTP Relay.

## Uninstalling the DirectAdmin Plugin

To uninstall the JetEmail DirectAdmin plugin:

1. Ensure you have root access to your DirectAdmin server.

2. Open a terminal or SSH into your server.

3. Remove the plugin using yum:

```bash theme={null}
yum remove jetemail-directadmin
```

4. Remove the JetEmail repository file:

```bash theme={null}
rm /etc/yum.repos.d/jetemail.repo
```

5. The plugin and all JetEmail configurations will be removed from your server.