Installation Guide
This section covers the complete installation process for NethVoice, from setting up the underlying NethServer 8 infrastructure to configuring NethVoice itself.
Overview
NethVoice installation is a two-step process:
- NethServer 8 Installation - Install the NethServer 8 base platform
- NethVoice Installation - Install and configure NethVoice application
What is NethServer 8?
NethServer 8 (NS8) is the underlying Linux infrastructure platform on which NethVoice runs. It provides:
- Open-source unified Linux infrastructure management
- Cluster support for high availability and scalability
- Modular application architecture
- Web-based administration interface
- Security hardening and updates
NethVoice requires NethServer 8 to be installed first. Ensure you complete the NethServer 8 installation before proceeding with NethVoice.
Installation Path
Step 1: Prerequisites
Before starting, ensure you have:
- A dedicated physical or virtual machine
- Supported Linux distribution installed (Rocky Linux, AlmaLinux, CentOS Stream, or Debian)
- Static IP address configured
- External DNS servers configured
- Working internet connection
- Fully Qualified Domain Name (FQDN) registered and resolved
Step 2: Install NethServer 8
Follow the NethServer Installation guide to:
- Install NethServer 8 core components
- Configure network and DNS
- Access the web administration interface
- Create your cluster
Step 3: Install and configure NethVoice
Follow the NethVoice Installation guide to:
- Install NethVoice
- Complete the setup configuration wizard:
- Configure an account provider
- Install and configure a NethVoice Proxy
- Set up virtual hosts, certificates and administration password
- Access NethVoice administration interface and CTI
Quick Reference
Minimum System Requirements
| Component | Requirement |
|---|---|
| CPU | 2 vCPU/cores (x86-64) |
| RAM | 2GB |
| Storage | 40GB SSD |
| Network | Static IP address |
| OS | Rocky Linux 9 (subscription supported) - AlmaLinux 9, CentOS Stream 9, Debian 12 (community supported) |
| Browser | Firefox, Chrome, or Chromium (current version) |
Installation Methods
NethServer 8 can be installed via:
- Standard installation script (recommended)
- Pre-built virtual machine image (for Proxmox or VMWare)
NethVoice is installed via:
- NethServer Software Center interface
Default Credentials
After installation, use these temporary credentials:
| Component | Username | Password |
|---|---|---|
| NethServer 8 Admin Interface | admin | Nethesis,1234 |
| NethVoice Admin Interface | admin | Nethesis,1234 |
Change default credentials immediately after first login for security.
Detailed Guides
NethServer 8 Installation
Complete guide covering:
- System requirements and hardware recommendations
- Supported Linux distributions
- Network and DNS configuration
- Standard installation procedure
- Pre-built image deployment
- Post-installation steps
- Cluster configuration
- Troubleshooting
NethVoice Installation
Complete guide covering:
- NethVoice software installation
- Setup wizard:
- User domain
- NethVoice Proxy
- Virtual hosts (base hosts)
- Let's Encrypt certificates
- Administration password
- Administrator access
- Initial configuration
NethVoice Proxy Installation
Complete guide covering:
- Proxy overview and architecture
- Role in single and multi-instance deployments
- Installation steps
- Configuration (domain, interface, public IP)
- SSL certificate setup
- Verification and testing
- Must be installed before NethVoice
Installation Checklist
Before you begin, ensure:
- Hardware meets minimum requirements (2 vCPU, 2GB RAM, 40GB SSD)
- Supported Linux distribution available
- Static IP address configured
- External DNS servers configured
- FQDN registered with DNS provider
- Firewall allows required ports (80, 443, 55820 for clustering)
- Internet connection is stable
- You have administrative access to the server
Important Notes
Supported Platforms Only: Install NethServer 8 on supported distributions only. Desktop systems and servers running other services are not supported.
Static IP Address: DHCP is not supported. Configure a static IP address before or during NethServer 8 installation.
DNS Configuration: Proper DNS setup is essential for TLS certificates, clustering, and overall system functionality. Do not skip DNS configuration steps.
Default Credentials: Change default admin passwords immediately after installation. This is a security requirement, not optional.
Scaling
After initial installation, NethServer 8 supports:
- Cluster Setup: Add multiple nodes for scalability
- Worker Nodes: Distribute applications across cluster nodes
- Load Balancing: Built-in load balancing for applications
- VPN: Automatic VPN setup for secure inter-node communication
See the NethServer 8 documentation for clustering details.
Troubleshooting
Common Issues
Cannot access web interface
- Verify static IP configuration
- Check firewall allows port 443
- Ensure DNS resolves the FQDN correctly
- See NethServer 8 installation guide
Network connectivity issues
- Configure static IP address
- Verify DNS servers are reachable and not local
- Check network interface configuration
- Test DNS resolution from command line
Installation script fails
- Ensure internet connection is stable
- Install curl if not available
- Run as root user
- Check system requirements are met
For additional help, refer to the detailed guides or NethServer 8 documentation.
Next Steps
After successful installation:
- Configure NethVoice: Complete the NethVoice configuration wizard
- Set up Users: Create user domains (LDAP or Active Directory)
- Provision Phones: See Phone Provisioning guide
- User Training: Use User Manual to train end users
- Security Hardening: Configure firewalls and access controls
Ready to get started? Begin with the NethServer 8 Installation guide.