Linkus Server Configuration
Purpose
Configure server-side settings that control how Linkus clients connect and behave.
Server Settings
Connection Parameters
Server URL
- FQDN: Your Cloud-PBX URL (e.g., company.voco.cloud)
- Purpose: Primary connection endpoint for Linkus clients
- SSL Certificate: Automatically provisioned and renewed
SIP Ports:
- Standard SIP: 5060 (UDP/TCP)
- Secure SIP (TLS): 5061 (TCP)
- WebRTC: 8089 (WSS)
RTP Port Range:
- Range: 10000-20000
- Purpose: Media streams for voice/video
- Firewall: Must be open for remote clients
Transport Protocols
- Default for local network
- Low overhead
- Less firewall-friendly
- More reliable
- Better for firewalls/NAT
- Slightly higher overhead
- Encrypted signaling
- Required for remote workers
- Highest security
- Browser-based clients
- Encrypted by default
- Firewall-friendly
Configuration
Navigate to Transport Settings
Go to Settings > Linkus Server > Transport
Enable Protocols
Enable desired protocols
Auto-Selection
Linkus clients auto-select best protocol
Save
Click Save
Authentication
Login Methods
- Standard authentication
- Username is extension number
- Password is user password
- Embedded credentials
- One-time use
- Expires after 24 hours
- SAML/OAuth integration
- Corporate identity provider
- No separate password
Configuration
Navigate to Authentication
Go to Linkus Server > Authentication
Enable Login Methods
Enable desired login methods
Configure SSO (if needed)
Set SAML endpoint and certificate if using SSO
Set Session Timeout
Set session timeout (1-30 days)
Configure Remember Me
Enable/disable "Remember Me" option
Save
Click Save
Push Notifications
Purpose
Deliver call notifications to mobile devices even when app is closed.
Requirements
- Apple Push Notification Service certificate
- Automatically configured for TheVoĉo Cloud
Settings:
- Enable Push: Yes/No
- Badge Count: Show unread count on app icon
- Sound: Play notification sound
- Banner: Show notification banner
Requirements
- Firebase Cloud Messaging configuration
- Automatically configured for TheVoĉo Cloud
Settings:
- Enable Push: Yes/No
- Priority: Default/High
- Notification Channel: Select Android channel
Configuration
Navigate to Push Settings
Go to Linkus Server > Push Notifications
Verify iOS APNS
Verify iOS APNS enabled
Verify Android FCM
Verify Android FCM enabled
Test Notifications
- Make test call to mobile extension
- Verify notification arrives on locked device
Save
Click Save
Troubleshooting
- Check device notification permissions
- Verify app not in battery saver mode
- Confirm push service status in admin portal
Feature Availability
Purpose
Enable/disable features globally for all Linkus clients.
Voice Features
- Voice Calls: Enable/disable calling functionality
- Video Calls: Enable/disable video calling
- Call Recording: Allow users to record calls
- Voicemail: Access voicemail in app
Messaging Features
- Team Chat: Internal messaging
- SMS: Send/receive SMS (if supported by carrier)
- File Sharing: Upload/download files
- Group Chat: Multi-user conversations
Collaboration Features
- Screen Sharing: Share screen during calls
- Whiteboard: Collaborative whiteboard
- Meetings: Schedule/join video meetings
- Presence: Show availability status
Advanced Features
- Call Park: Park and retrieve calls
- BLF: Monitor extension status
- Shared Line: Multiple users on one extension
- Intercom: Auto-answer calls
Configuration
Navigate to Features
Go to Linkus Server > Features
Enable/Disable Features
Check to enable features, uncheck to disable and hide from all users
Save
Click Save
Result
Features instantly enabled/disabled across all connected clients.
Client Updates
Auto-Update Policy
Update Options
- Auto-Install: Updates install automatically
- Notify User: Prompt user to update
- Manual Only: User must download manually
- Controlled by App Store / Google Play
- Users receive update notifications
- Can configure MDM to force updates
Configuration
Navigate to Updates
Go to Linkus Server > Updates
Select Policy
Select auto-update policy
Beta Channel
Enable/disable beta channel
Save
Click Save
Version Control
Minimum Version
Set minimum allowed client version to block older versions and force upgrades.
Set Desktop Version
Set Minimum Desktop Version (e.g., 7.0.0)
Set Mobile Version
Set Minimum Mobile Version (e.g., 6.5.0)
Save
Click Save
Result
Clients below minimum version cannot connect until upgraded.
Bandwidth & Quality
Codec Configuration
Priority Order
- OPUS: High quality, low bandwidth (recommended)
- G.722: HD voice quality
- G.711: Standard quality, high compatibility
- G.729: Low bandwidth, compressed
- VP8: WebRTC standard
- H.264: Wide compatibility
Navigate to Media Settings
Go to Linkus Server > Media
Reorder Codecs
Drag codecs to reorder priority
Disable Unwanted Codecs
Disable codecs not needed
Save
Click Save
QoS Settings
DSCP Marking
- Voice: EF (46) - Expedited Forwarding
- Video: AF41 (34) - Assured Forwarding
- Signaling: CS3 (24) - Class Selector
Purpose: Prioritize traffic on QoS-enabled networks.
Navigate to QoS
Go to Linkus Server > QoS
Enable DSCP
Enable DSCP marking
Configure Values
Configure values (use defaults for standard deployments)
Coordinate
Coordinate with network team
Save
Click Save
Security Settings
Encryption
- TLS 1.2+: Required for security
- Certificate: Auto-provisioned Let's Encrypt
- Verification: Strict certificate validation
- SRTP: Encrypted audio/video streams
- Mandatory: Require SRTP for all calls
- Optional: Fall back to RTP if needed
Navigate to Security
Go to Linkus Server > Security
Enable TLS
Enable Require TLS
Enable SRTP
Enable Require SRTP
Save
Click Save
Access Control
Restriction Options
- IP Whitelist: Restrict connections to specific IP ranges (use case: corporate network + VPN only)
- Geographic Restrictions: Block connections from specific countries (use case: prevent international fraud)
Navigate to Access Control
Go to Linkus Server > Access Control
Add IP Ranges
Add allowed IP ranges
Add Blocked Countries
Add blocked countries
Save
Click Save
Logging & Monitoring
Activity Logs
Monitor Client Activity
- Login/logout events
- Call activity
- Feature usage
- Error events
Access: Navigate to Reports > Linkus Activity
Real-Time Status
View Connected Clients
- Extension number
- Client type (mobile, desktop, web)
- IP address
- Connection time
- Status (online, idle, in call)
Access: Navigate to Dashboard > Linkus Status
Troubleshooting
Clients Cannot Connect
- Verify Linkus Server is enabled
- Check firewall rules (5060, 5061, 8089, 10000-20000)
- Test with Web Client (easiest to diagnose)
- Review connection logs
No Audio on Calls
- Verify RTP ports open (10000-20000)
- Check NAT traversal settings
- Test different codecs
- Review media logs
Push Notifications Fail
- Verify push service status
- Check device notification permissions
- Confirm app not in battery saver mode
- Test with different device
Poor Call Quality
- Run network bandwidth test
- Enable QoS if available
- Switch to lower-bandwidth codec (G.729)
- Check for network congestion
Configuration Steps
Navigate to Linkus Server
Go to Settings > Linkus Server
Connection Tab
- Verify server URL
- Enable required transport protocols
Authentication Tab
- Configure login methods
- Set session timeout
Push Notifications Tab
- Verify push services enabled
- Test notifications
Features Tab
- Enable desired features
- Disable unused features
Media Tab
- Order codec priority
- Configure QoS
Security Tab
- Require TLS/SRTP
- Configure access control
Updates Tab
- Set auto-update policy
- Set minimum versions
Save and Apply
Click Save and Apply Config
Result
Linkus Server configured. Changes apply to all clients immediately (may require reconnect).