---
sidebar_position: "1"
title: "Airia Cloud Connector Pre-Installation Checklist"
sidebarTitle: "Airia Cloud Connector"
---

### Overview

The Airia Cloud Connector (ACC) is a background service daemon that enables secure communication between your private network and the Airia Cloud platform.

The ACC establishes a secure, outbound connection from your network to the Airia Cloud Platform, allowing Airia services to interact with your internal systems without exposing them to the internet. This approach maintains your network security boundaries while enabling powerful hybrid cloud capabilities.

**Key Security Benefit**: The ACC requires no inbound ports to be opened from the internet, significantly enhancing your security posture while enabling cloud integration.

**Example Use Case**: Many organizations use ACC to securely connect private applications (like an internal CRM) that are restricted to corporate networks. The ACC creates a secure tunnel between your private application and the Airia platform without requiring direct internet exposure of your application.

For high availability deployments, multiple ACC servers can be deployed, each establishing independent connections to the Airia Cloud Platform. Load balancing is handled automatically by the Airia platform.

This checklist will help you prepare for deploying the ACC in your environment. Complete all applicable items before proceeding with installation.

### Accessing and Downloading the Cloud Connector

1. Navigate to **Settings** from the top navigation.
2. In the left-hand navigation panel, select **Cloud Connectors**.
3. Click **Download Cloud Connector**.
4. Choose the installer for your preferred platform: **Windows**, **macOS**, or **Linux**.
5. Once the installation package (ZIP) is downloaded, open it to access the detailed installation steps included inside.

**IMPORTANT**: The Deployment Details Worksheet at the end of this document should be completed during the installation process. This information is essential for future reference and troubleshooting.

### Infrastructure Access Prerequisites

- Administrative access to servers where ACC will be installed
- Access to all ACC servers
- Administrative access to network infrastructure (firewalls, routers)
- Permissions to create and manage:
  - Virtual machines or servers
  - Network segments/VLANs
  - Firewall rules

### Infrastructure Prerequisites

- Server deployment (1 minimum, 2 recommended for high availability)
- Resources per server:
  - Minimum 1 vCPU
  - Minimum 1GB RAM
- Supported operating systems:
  - Windows Server
  - Linux
  - macOS

**Note**: ACC can be deployed on any physical or virtual infrastructure as long as it meets the OS requirements above and has network connectivity to both the Airia Cloud platform and your internal services.

### Network Prerequisites

- Internet access for ACC servers
- DNS resolution for Airia domains
- DNS resolution for Internal services

### Connectivity Requirements

The following tables outline the specific network connectivity requirements:

#### Outbound Connectivity (Required)

| Source     | Destination | Protocol | Port | Purpose                                     |
| ---------- | ----------- | -------- | ---- | ------------------------------------------- |
| ACC Server | airia.ai    | HTTPS    | 443  | Communication with all Airia Cloud services |
| ACC Server | \*.airia.ai | HTTPS    | 443  | Communication with all Airia Cloud services |

#### Internal Connectivity

| Source     | Destination   | Protocol | Port | Purpose                            |
| ---------- | ------------- | -------- | ---- | ---------------------------------- |
| ACC Server | Internal APIs | HTTP     | 80   | Standard HTTP to internal services |
| ACC Server | Internal APIs | HTTPS    | 443  | Secure HTTPS to internal services  |
| ACC Server | Internal APIs | Custom   | \*   | Custom ports (if required)         |

### High Availability Configuration

For production environments, we recommend deploying at least two ACC servers for redundancy. When multiple ACC servers are deployed:

- Each ACC server establishes an independent connection to the Airia Cloud platform
- Load balancing is automatically handled by the Airia platform
- If one ACC server becomes unavailable, traffic automatically routes through functioning servers
- No additional load balancer configuration is required on your end

<Note>
  Ensure each ACC server has equivalent network access to all required internal services.
</Note>

### Tools Prerequisites

- SSH client for server access
- Access to Airia documentation
- Monitoring tools (optional)

### Security & Credentials

- Server security:
  - Secure passwords/SSH keys
  - Restricted SSH access
  - Properly configured firewall rules
- Airia Cloud Connector authentication credentials
- TLS certificates (if using HTTPS):
  - Certificates installed
  - Renewal process documented
  - Secrets management process

### Pre-Installation Configuration

- Server hostnames and IPs documented
- Network configuration documented
- Firewall rule modifications prepared

### Service Integrations

- Application connection details documented
- Integration testing plan developed
- API access credentials prepared
- Data flow mapping documented

## Next Steps

Once you have completed all the items in this checklist and gathered the required information, you will be ready to proceed with ACC installation. 

<Note>
  Once you download the installation package (connector ZIP), you will gain access to the full set of installation steps contained within that package. Please follow those embedded instructions for proper setup. 
</Note>

The installation guide will walk you through the actual deployment process. Having completed this pre-installation checklist will ensure a smooth and efficient installation experience.

For any questions or clarifications about these pre-installation requirements, please contact Airia support at [support@airia.ai](mailto:support@airia.ai).

## Deployment Details Worksheet

<Info>
  Use this worksheet to record key details about your deployment during the installation process. This information is essential for future reference and troubleshooting.
</Info>

### Infrastructure Details

#### ACC Servers

Server 1:

- Hostname/IP:
- Specifications:
- Operating System:
- SSH / Remote Access:

Server 2:

- Hostname/IP:
- Specifications:
- Operating System:
- SSH / Remote Access:

### Airia Configuration

#### Airia Cloud Access

- Airia Cloud Connector Token:

#### Customer Applications

Application 1:

- Name:
- Connection Type:
- Ports Required:
- Contact Person:

Application 2:

- Name:
- Connection Type:
- Ports Required:
- Contact Person:

### Support Information

- Airia Support Contact:
- Internal Support Contact:
- Deployment Date:
- Maintenance Window:

After completing this checklist and worksheet, proceed with the installation instructions for the Airia Cloud Connector service.

## Support and Troubleshooting

In the case you need support with your Airia On-Premises Deployment, reach out to the Airia support team directly at [support@airia.com](mailto:support@airia.com). The team will be able to support in line with your contracted service agreement.