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

> ## Agent Instructions
> AhaSend stores all message data in the EU. See /facts.
> The API base URL is https://api.ahasend.com. Send the API key in the Authorization: Bearer header. See /api-reference/authentication.
> Use send.ahasend.com for SMTP. Ports 25, 587 and 2525 use STARTTLS. Port 465 is not supported. See /smtp.
> For send-only integrations, create an API Key v2 under Credentials → Add and scope it to messages:send:{your-domain}. See /send-api/credentials and /api-reference/scopes.

# Bring Your Own IP (BYOIP) for Email Sending

> Send AhaSend email from IP addresses you own, through a server AhaSend configures. A Max plan add-on; setup takes up to 7 business days.

AhaSend lets you send through your own IP addresses on a VPS; this guide explains the requirements and setup for bringing your own IPs.

Available as a Max add-on. See [plans and features](https://ahasend.com/docs/facts.md#plans-and-features).

> [!TIP]
>
> **Max Plan Feature:** Bring Your Own IP is available exclusively on the [Max plan](https://ahasend.com/pricing) as an add-on. [Contact our sales team](https://ahasend.com/contact) to discuss setup and pricing.

> [!WARNING]
>
> **Advanced Setup:** BYOIP comes with unique challenges similar to dedicated IP management. Ensure you understand IP reputation, deliverability requirements, and maintenance responsibilities before proceeding.

## Requirements

Before requesting BYOIP setup, prepare the following infrastructure:

### VPS Specifications

**Minimum Server Requirements:**

* **Operating System:** Ubuntu (latest LTS recommended)
* **CPU:** 2 cores minimum
* **RAM:** 4GB minimum
* **Storage:** Minimal disk space required
* **Location:** Provider that allows outgoing port 25 traffic

### Network Configuration

**Required Network Access:**

* **Ingress Traffic:** Allow port 22 (SSH) and 5000 from our IPs (we'll provide them to you)
* **Egress Traffic:** Allow all outbound traffic on port 25 (SMTP)
* **Public IP:** Static public IP address for AhaSend connection

### Access Requirements

**SSH Configuration:**

* **SSH Access:** Root or sudo access for configuration
* **SSH Key:** Add AhaSend's public SSH key (provided via email)
* **Security:** Secure SSH configuration with key-based authentication

## Setup Process

**1. Prepare Infrastructure**

**Set up your VPS and network:**

1. **Deploy** Ubuntu VPS with required specifications
2. **Configure** network firewall rules
3. **Secure** SSH access and obtain public IP address

**2. Contact AhaSend**

**Provide configuration details:**

Send us the following information:

* **VPS Public IP:** The IP address we can use to connect
* **Sending IPs:** List of IP addresses you want to use for sending
* **Volume Requirements:** Expected email volume and usage patterns

**3. Configuration & Testing**

**AhaSend completes setup:**

1. **SSH Key Exchange:** We'll send our public SSH key via email
2. **Server Configuration:** Our team configures your VPS (up to 7 business days)
3. **IP Integration:** Your IP addresses are added to your AhaSend account
4. **Testing:** Verify configuration and sending functionality

## Important Considerations

> [accordion] IP Reputation Management
>
> **Managed by AhaSend or customer (depending on agreement):**
>
> * **Warm-up Process:** Gradually increase sending volume on new IPs
>
> * **List Hygiene:** Maintain clean recipient lists to avoid bounces
>
> * **Monitoring:** Track deliverability metrics and reputation scores
>
> * **Blacklist Management:** Handle any blacklist issues promptly
>
> > [!NOTE]
> >
> > **Flexible Management:** IP reputation can be managed by our team or handled by your organization based on your service agreement and preferences.

> [accordion] Infrastructure Maintenance
>
> **Ongoing requirements:**
>
> * **VPS Uptime:** Maintain server availability and performance
> * **Security Updates:** Keep system updated and secure
> * **Network Monitoring:** Ensure connectivity and port availability
> * **Backup Planning:** Implement appropriate backup strategies

> [accordion] Deliverability Challenges
>
> **Potential issues:**
>
> * **Cold IP Reputation:** New IPs require careful warming
> * **Provider Restrictions:** Some ISPs may be more restrictive
> * **Volume Limitations:** Start with lower volumes and scale gradually
> * **Technical Expertise:** Requires understanding of email infrastructure

## Related Guides

* [Account quickstart](https://ahasend.com/docs/quickstart.md), [Dedicated IPs](https://ahasend.com/docs/scale/dedicated-ips.md), [IP pools](https://ahasend.com/docs/scale/ip-pools.md).
* [Sending guide](https://ahasend.com/docs/send-api/send-email.md), [Plans and limits](https://ahasend.com/docs/facts.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.