Installation Guide

Download and install VoiceLink on your platform

Choose the Right Installer

Desktop app

Best when you want the full VoiceLink experience with room audio, server switching, admin tools, offline docs, and built-in updates.

Example: choose this if you moderate rooms, run media, or switch between Main, Community, and your own server during the day.

Server installer

Best when you want to host your own VoiceLink server and connect it to the main API for licensing, updates, and module sync.

Example: choose this for a VPS, home server, or hosted Linux box where you want your own rooms and policies.

Portable or archive builds

Best when you need a test copy without a full install, or when you want to compare versions safely.

Example: use a ZIP build on a shared support machine or for regression testing before replacing the main installed app.

System Requirements Overview

Component Minimum Recommended
Processor Dual-core 2.0 GHz Quad-core 2.5 GHz+
RAM 4 GB 8 GB+
Storage 500 MB 1 GB+
Network Broadband 5 Mbps 10+ Mbps, low latency
Audio Microphone + Speakers Headset with noise cancellation
Why these requirements matter: VoiceLink does more than plain voice chat. Desktop builds can run room audio preview, background media, transcription, admin tools, and federated server browsing at the same time. If you host a server, extra CPU and RAM help when many rooms, bots, or media features are active.
🍎

macOS Installation

macOS 10.15 Catalina or later

Download Options

Package Architecture Size Description
DMG (Apple Silicon) arm64 421 MB For M1/M2/M3 Macs - Recommended
DMG (Intel) x86_64 426 MB For Intel-based Macs
ZIP (Apple Silicon) arm64 416 MB Portable - no installation required
ZIP (Intel) x86_64 421 MB Portable - no installation required

Installation Steps

  1. Download the appropriate version for your Mac (Apple Silicon or Intel)
  2. Open the downloaded DMG file by double-clicking
  3. Drag VoiceLink to your Applications folder
  4. Launch from Applications or Spotlight search
  5. Allow microphone access when prompted
First Launch: On first run, you may need to right-click and select "Open" to bypass Gatekeeper. This is only required once.
💻

Windows Installation

Windows 10 or Windows 11

Download Options

Package Architecture Size Description
ZIP (64-bit) x64 440 MB Portable - Recommended for most users
ZIP (32-bit) x86 422 MB For older 32-bit systems

Installation Steps

  1. Download the 64-bit ZIP (or 32-bit for older systems)
  2. Extract the ZIP file to your preferred location (e.g., Desktop or Program Files)
  3. Open the extracted folder
  4. Run "VoiceLink.exe"
  5. Allow microphone and network access when prompted by Windows
Tip: Right-click "VoiceLink.exe" and select "Pin to Start" or "Pin to taskbar" for quick access.
🐧

Linux Installation

Ubuntu 18.04+, Debian 10+, Fedora 30+, or equivalent

Download Options

Package Format Size Best For
AppImage Universal 423 MB Any distribution - Recommended
DEB Package .deb 281 MB Ubuntu, Debian, Linux Mint
TAR.GZ Archive .tar.gz 376 MB Manual installation on any distro

AppImage Installation (Recommended)

  1. Download the AppImage file
  2. Make executable: chmod +x VoiceLink\ Local-1.0.0.AppImage
  3. Run: ./VoiceLink\ Local-1.0.0.AppImage

DEB Package Installation

sudo dpkg -i voicelink-local_1.0.0_amd64.deb sudo apt-get install -f # Fix dependencies if needed

Audio System Configuration

Audio System Check Command Notes
PulseAudio pulseaudio --check Default on Ubuntu/Fedora - works out of box
ALSA aplay -l Low-level audio - check device permissions
JACK jack_control status Professional low-latency - start before VoiceLink
PipeWire pw-cli info Modern replacement - full compatibility
⚙

Server Deployment

Self-hosted VoiceLink server for teams and organizations

Server Requirements

Specification Small (up to 100 users) Medium (up to 500 users) Large (1000+ users)
CPU 2 cores, 2.0 GHz 4 cores, 2.5 GHz 8+ cores, 3.0+ GHz
RAM 2 GB 8 GB 16+ GB
Storage 1 GB SSD 5 GB SSD 10+ GB SSD
Network 10 Mbps 100 Mbps 1 Gbps
Users per Room 50 250 5000

Quick Server Install

# Download and extract wget https://voicelinkapp.app/downloads/voicelink/voicelink-server-1.0.0.tar.gz tar -xzf latest.tar.gz cd voicelink-local # Install dependencies npm install --production # Configure (edit deploy.json) cp data/deploy.json.example data/deploy.json nano data/deploy.json # Start server npm start
Web Installer Available: For servers without SSH access, use the Web Installer for guided setup through your browser.
Recommended owner setup order: Configure the server first, then create or link the owner's VoiceLink and client portal accounts. This lets the installer connect back to the main API, register the server, and attach the correct shared license to both the owned server and the owner's desktop client.

Recommended First-Time Server Owner Flow

  1. Use Deploy or Set Up New Server from the desktop client or server admin flow.
  2. Choose whether the install should live on a subdomain, in a side-by-side app directory, or at site root only if you explicitly want full replacement.
  3. Create or link the client portal account so billing, licensing, owned domains, and support details all stay tied to the same owner identity.
  4. Let VoiceLink link supported identity sources such as VoiceLink sign-in, WHMCS account, cPanel user, owned domain, or /home/<user> install path.
  5. For WHMCS installs such as /home/devinecr/public_html, keep the billing portal in place and let VoiceLink integrate through addon, template, and client/admin bridge paths instead of replacing the site root.
  6. Confirm that Main, Community, and the new owned server all appear in the desktop app once licensing finishes syncing.
License retention: owned installs can stay linked even when they are not online every day, but long-term inactive installs may eventually be purged from the central API after warning notices. This does not delete the installed server data. It means the owner may need to reconnect and re-register the install later. Main platform servers are exempt, and paid non-purge or extended-retention options can keep an owned install active longer.

Using VoiceLink with an Existing Website

Keep the existing site

Recommended default. Deploy VoiceLink beside the current site and keep your home page, WordPress content, or custom pages untouched.

Example: keep walterharper.com as the main site and run VoiceLink at voice.walterharper.com or from an app directory under the same account.

Integrate with WordPress

When WordPress is detected, use the bundled VoiceLink plugin to create pages, add shortcodes, and expose owner/site context without replacing the whole site.

Example: add a VoiceLink downloads page, help page, and server setup page to an existing membership or community site.

Replace site root

Only choose this when the owner explicitly wants the full internal VoiceLink web UI to become the primary site.

Example: a fresh domain dedicated only to VoiceLink where no existing CMS or public website needs to be preserved.

🌐

Web Installer

Browser-based installation for hosting providers

The Web Installer allows you to set up VoiceLink on web hosting without SSH access.

Requirements

Feature Required Notes
Node.js v18.0.0+ Check with hosting provider
File Upload Yes FTP, cPanel, or file manager
Domain/Subdomain Yes SSL certificate recommended
WebSocket Support Yes Required for real-time communication

Installation Steps

  1. Download the server package from the Downloads page
  2. Upload all files to your web hosting via FTP or file manager
  3. Navigate to yourdomain.com/install.html in your browser
  4. Follow the on-screen setup wizard
  5. Configure your server name, admin credentials, and features
  6. Complete installation and access your admin panel
Security Note: After installation completes, delete or rename install.html to prevent unauthorized reinstallation.

Troubleshooting Quick Reference

Issue Possible Cause Solution
App won't start Missing dependencies Reinstall or check system requirements
No microphone audio Permissions not granted Check system privacy settings
Can't hear others Wrong output device Check Audio Settings in app
Connection failed Firewall blocking Allow VoiceLink through firewall
High latency Network congestion Use wired connection, close other apps

Full Troubleshooting Guide