Skip to content

Set Up and Manage SIP Lines

A line connects TelefonX to a SIP account. Open TelefonX › Settings … › Lines. TelefonX Free registers the first line. Pro can keep multiple lines connected at the same time.

Find connection details and provider-specific proxy requirements under SIP Providers and Connection Settings.

  1. Click Add Line ….
  2. Enter a name such as “Office”, “Home”, or the location.
  3. Enter the Domain / Server, SIP Username, and Password.
  4. Select UDP, TCP, or TLS according to your SIP provider’s instructions.
  5. Keep Line Enabled on and save.
FieldMeaning
NameLabel shown in the dialer, calls, and menu bar
Domain / ServerHost name or IP address, optionally with a port. No sip:// and no path
SIP UsernameSIP identifier supplied by the provider
PasswordSIP password stored in the macOS Keychain
ConnectionDefault (UDP), TCP, or TLS · Encrypted Signaling
Hide My Caller IDRequests permanent caller-ID suppression. The provider or phone system must support it

The colored status shows whether a line is connected, connecting, unavailable, or disabled. Reconnect is available for failed or offline registration.

  • Drag the handle to reorder lines, or use Move Up and Move Down in the context menu.
  • Choose a Default Line for new calls.
  • Editing and deleting are disabled during a call.
  • Delete Line and Password removes the credentials. Recents remain and continue to show the line name recorded at the time.

Without Pro, only the first line in the order is active. Additional stored lines remain saved but locked. Move the desired line to the first position. If Pro expires during a call on an additional line, the call can finish before the line is unregistered. Eligible lines reconnect when Pro becomes active again.

Every line can use a built-in ringtone. Custom audio files require Pro. If a saved custom file is missing or Pro is inactive, TelefonX temporarily uses the default ringtone. Use Preview Audio before saving.

Open Data & Diagnostics › Connection Help and click Technical Options … for the line. Change these values only when instructed by the provider:

OptionPurpose
Authentication NameSeparate identifier. If left empty, uses the SIP username
RegistrarSeparate registration server. If left empty, uses Domain / Server
Outbound ProxyOptional proxy as a host or Host:Port
STUN ServerOptional server as a host or Host:Port that discovers the audio address visible outside your network
Registration: … SecondsAdjustable from 60 to 3,600 seconds
Require SRTPRequires encrypted media and is available only with TLS
G.711 Only (Compatibility Mode)Compatibility mode for older phone systems
Enable ICEAssists connection discovery in suitable networks
Use Registration Address for AudioUses the address reported by the registrar for audio over UDP

Use Registration Address for Audio is off by default. This option may help with audio issues on UDP lines behind NAT. It is available only for Default (UDP) when Enable ICE is off and STUN Server is empty. Click Save and make a test call to check audio in both directions.

TelefonX normally selects the best shared codec automatically.

After network, VPN, or wake changes, TelefonX attempts to restore registration automatically. If necessary, choose Phone › Reconnect Lines or use Rebuild SIP Connections under Data & Diagnostics.

TelefonX Pro offers a separate FRITZ!Box integration and elunos.ai integration for each SIP line. Their configuration pages explain setup, line assignment, and credential storage.

Deleting a line removes its local integration settings and credentials without changing an external forwarding rule or published route. Deletion is blocked during an integration operation for that line.