Docs

Start here if you are installing KubeVoIP or trying to understand how the pieces fit together. For a new setup, install the chart, run the two-phone quickstart, then read the networking and PostgreSQL pages before adding real users or trunks.

Getting started

• Install KubeVoIP with Helm OCI into a namespace-scoped operator release.
• Run the two-phone quickstart with the kubevoip CLI and place your first SIP call.
• Clean up the quickstart when you are done.

Concepts

• Platform resources explains how SIPGateway, MediaRelay, SIPUser, SIPTrunk, CallScope, DialPolicy, CallRoute, and AsteriskPool fit together.

Networking

• SIP on Kubernetes explains the signaling and media flow.
• LoadBalancer networking covers Services, external addresses, and UDP port preservation.
• HostNetwork media mode covers the node-level media path for clusters where Service NAT is not a fit.

Operations

• PostgreSQL covers runtime data, migrations, and HA1 storage.
• Secrets explains credential handling.
• Observability covers SIP/RTP logs and optional HOMER HEP capture.
• Production setup explains real SIP device credentials, production PostgreSQL, and dial policy.
• Troubleshooting gives the first commands to run when registration, routing, or media is not working.

Reference

• API reference is generated from the current CRDs.
• Helm values and component images document release inputs.

Contributing

• Local development and release process describe project workflow.