---
title: How To transfer cPanel Emails to FastPanel using Semaphore
description: "This guide provides step-by-step instructions on how to transfer emails from **cPanel** to **FastPanel** using **Semaphore**. Follow these steps carefully to ensure a smooth and successful email migration. --- ## **Step 1: Log in to Semaphore** 1. Go to the Semaphore dashboard. 2. Log in…"
url: "https://truehost.com/support/knowledge-base/how-to-transfer-cpanel-emails-to-fastpanel-using-semaphore/"
updated: "2025-01-15"
category: Fastpanel
---

# How To transfer cPanel Emails to FastPanel using Semaphore

This guide provides step-by-step instructions on how to transfer emails from **cPanel** to **FastPanel** using **Semaphore**. Follow these steps carefully to ensure a smooth and successful email migration.

---

## **Step 1: Log in to Semaphore**

1. Go to the Semaphore dashboard.
2. Log in using your credentials.

![](https://truehost.com/support/wp-content/uploads/2025/01/image-79.png)

## **Step 2: Edit the Environment Tab**

1. On the left sidebar, click on **Environment**.
2. Locate the **"Emails Transfer - cPanel to Fastpanel"** Environment file on the right side.
3. Click **Edit** to modify the file.

![](https://truehost.com/support/wp-content/uploads/2025/01/image-80-1024x500.png)

### **Edit the Following Variables:**

- **Domain**: `your-domain.com` (Replace with your actual domain name.)
- **Cpanel_user**: `your-cpanel-username` (Replace with your cPanel username.)
- **Common_Password**: `your-password` (Replace with the common password for the emails.)

![](https://truehost.com/support/wp-content/uploads/2025/01/image-81-1024x485.png)

> ### **Important Note:**
>
>
>
> - Your password **MUST NOT** contain a semi-colon (`;`). This is because FastPanel expects a list of emails to be imported, separated by semi-colons. Including a semi-colon in your password will cause the import process to fail.

### **Example of FastPanel's Expected Input:**

```
host.hostname.cloud;email@domain.com;fnb35HAG7ar;email@domain.com
host.hostname.cloud;email@domain.com;fnb35HAG7ar;email@domain.com
```

- **host.hostname.cloud**: The source server hostname.
- **[email@domain.com](mailto:email@domain.com)**: The email address to be transferred.
- **fnb35HAG7ar**: The password for the email.

After editing, click **Save**.

## **Step 3: Edit the Inventory Tab**

1. On the left sidebar, click on **Inventory**.
2. Locate the **"Emails Transfer - cPanel to Fastpanel"** Inventory file on the right side.
3. Click **Edit** to modify the file.

###

![](https://truehost.com/support/wp-content/uploads/2025/01/image-91-1024x500.png)

### **Edit the Following Variables:**

#### **Source Server:**

```
[source_server]
server.hostname.cloud:22
```

- Replace `server.hostname.cloud` with the hostname of your cPanel server.
- `:22` refers to the SSH port (default is 22).

#### **Target Server:**

```
[target_server]
server.hostname.com:22
```

- Replace `server.hostname.com` with the hostname of your FastPanel server.
- `:22` refers to the SSH port (default is 22).

#### **Target Server Variables:**

```
[target_server:vars]
ansible_ssh_user=user
ansible_ssh_pass=password
ansible_ssh_private_key_file=null
```

- Replace `user` and `password` with your FastPanel server's SSH credentials.
- If using an SSH key, replace `null` with the path to your private key file.

After editing, click **Save**.

![](https://truehost.com/support/wp-content/uploads/2025/01/image-83-1024x490.png)

## **Step 4: Run the Task Template**

1. Click on the **Task Templates** tab.
2. Filter the templates by selecting **Transfers**.
3. Locate and click on the **"Emails Transfer - cPanel to Fastpanel"** template.
4. Click **Run** to initiate the `fastpanel.yml` Ansible playbook.

### **What Happens Next:**

- The script will begin transferring emails from cPanel to FastPanel.
- The time taken depends on the number of emails and their sizes.
- Once completed, you will see a **success message**.

![](https://truehost.com/support/wp-content/uploads/2025/01/image-84-1024x293.png)

Click Run

![](https://truehost.com/support/wp-content/uploads/2025/01/image-85-1024x407.png)

Transfer in Progress.

![](https://truehost.com/support/wp-content/uploads/2025/01/image-86-1024x447.png)

Transfer complete and successful.

![](https://truehost.com/support/wp-content/uploads/2025/01/image-87-1024x431.png)

## **Step 5: Confirm Email Transfer**

1. Log in to your **FastPanel** server.
2. Navigate to the site where you transferred the emails.
3. Click on **Mail** > **Mailboxes**.
4. Verify that all your emails are listed.

![](https://truehost.com/support/wp-content/uploads/2025/01/image-88-1024x360.png)

Mailboxes.

![](https://truehost.com/support/wp-content/uploads/2025/01/image-89-1024x313.png)

Email boxes available.

![](https://truehost.com/support/wp-content/uploads/2025/01/image-90-1024x500.png)

## **Conclusion**

You have successfully transferred your emails from **cPanel** to **FastPanel** using **Semaphore**. If you encounter any issues, double-check the variables and ensure your password does not contain a semi-colon (`;`).