Skip to content

Onboarding Guide

Welcome to Astradial. This guide will help you get oriented with our systems, tooling, and workflows.

What Astradial Does

Astradial is a cloud PBX company. Our core product routes voice calls from Tata Communications SIP trunks through an on-premise Intel NUC gateway, across a WireGuard tunnel, to a cloud-hosted Asterisk PBX. This architecture gives us carrier-grade reliability at the edge with the flexibility of cloud-based call routing and management.

System Components Overview

Component Role Location
Intel NUC On-premise SIP gateway, terminates Tata SIP trunk Local network (Debian)
Cloud Asterisk Cloud PBX, call routing, dialplan logic VPS at 89.116.31.109
WireGuard Encrypted tunnel between NUC and cloud (10.10.10.0/24) Both NUC and cloud
Cloudflare DNS, Cloudflare Tunnel for remote SSH to NUC Cloud (SaaS)
Netdata Real-time monitoring dashboards Both NUC and cloud
Upptime Uptime monitoring and status page GitHub Actions

How a Call Flows

Tata SIP Trunk --> NUC (PJSIP) --> WireGuard Tunnel --> Cloud Asterisk --> Endpoints

The NUC registers with Tata as a SIP endpoint, receives inbound calls on configured DIDs, and forwards them over the WireGuard tunnel to the cloud Asterisk instance. Outbound calls follow the reverse path.

First Steps

  1. Get access. Follow the Access Setup guide to get SSH keys provisioned and tools installed.
  2. Read the architecture docs. Understand the full call flow before touching any configuration.
  3. Check monitoring dashboards. Familiarize yourself with the Netdata dashboards on both the NUC and cloud server. Know what "normal" looks like before you need to debug an issue.
  4. Set up your softphone. Install Zoiper and connect to the dev SIP endpoint. See Required Tools.

Key Contacts

Person Role Email
Hari Prasath Lead / Architecture hari@astradial.com

For urgent issues affecting call routing, contact Hari directly.

Important Rules

Never compile software on the NUC

The Intel NUC has limited thermal headroom. Compilation workloads cause sustained CPU load that risks overheating and thermal shutdown. This can interrupt live call routing. Always cross-compile elsewhere or use pre-built packages.

Use --static-only for installs

When installing packages or dependencies on the NUC, always use the --static-only flag where applicable. This avoids pulling in unnecessary shared libraries that can conflict with the telephony stack.

Do not modify PJSIP configs without understanding the call flow

PJSIP configuration on the NUC controls how Tata SIP trunks are terminated and how calls are forwarded to the cloud. A misconfiguration can silently drop calls or cause registration failures with the carrier. Always trace the full call path before making changes, and test with sngrep after any modification.

Documentation Map