From 9f3f3bd4d1d807ae1068c1366b9ce6463f6495aa Mon Sep 17 00:00:00 2001 From: Andrea Leardini Date: Tue, 13 Jan 2026 15:00:28 +0100 Subject: [PATCH 01/22] fix(admin_manual): ns8 wizard and settings refactored --- .../advanced/nethvoice_proxy.md | 41 ++-- .../configuration/index.md | 1 + docs/administrator-manual/index.md | 6 +- docs/administrator-manual/install/index.md | 95 ++------- .../install/nethserver.md | 57 +----- .../install/nethvoice_install.md | 192 ++++++++++-------- 6 files changed, 152 insertions(+), 240 deletions(-) diff --git a/docs/administrator-manual/advanced/nethvoice_proxy.md b/docs/administrator-manual/advanced/nethvoice_proxy.md index fb253c9..451fb3b 100644 --- a/docs/administrator-manual/advanced/nethvoice_proxy.md +++ b/docs/administrator-manual/advanced/nethvoice_proxy.md @@ -69,13 +69,17 @@ In this scenario: ## Installation {#installation} +### Recommended installation: {#installation-steps} + +NethVoice proxy is installed as part of the NethVoice module setup wizard. See [NethVoice Installation](../install/nethvoice_install.md) for the complete installation sequence. + +### Manual installation (not recommended): + :::note You can install only one NethVoice Proxy per node from the Software Center. ::: -NethVoice Proxy must be installed **before** deploying any NethVoice instances. See [NethVoice Installation](../install/nethvoice_install.md) for the complete installation sequence. - -### Installation Steps {#installation-steps} +NethVoice Proxy must be installed **before** deploying any NethVoice instances. 1. **Open NethServer Management Interface** on your node 2. **Navigate to Software Center** @@ -83,17 +87,8 @@ NethVoice Proxy must be installed **before** deploying any NethVoice instances. 4. **Click "Install"** and wait for installation to complete 5. **Proceed to Configuration** (see section below) -:::warning Installation Order -Do not attempt to install NethVoice before installing and configuring NethVoice Proxy. The installation will fail if the proxy is not available. - ## Configuration {#configuration} -Configuration of NethVoice Proxy is essential before installing NethVoice instances. The proxy requires a dedicated FQDN and proper network settings. - -:::warning Configuration Required -NethVoice Proxy must be fully configured and operational before installing NethVoice instances. Verify configuration is complete and proxy is running before proceeding to NethVoice installation. -::: - ### Prerequisites {#prerequisites} Before configuring NethVoice Proxy, ensure: @@ -104,19 +99,21 @@ Before configuring NethVoice Proxy, ensure: ### Configuration Steps {#configuration-steps} +NethVoice Proxy is usually configured during the setup wizard of a NethVoice module (see [NethVoice Installation](../install/nethvoice_install.md) for the complete installation sequence). To review or modify the proxy configuration: + 1. **Access the proxy configuration page** in the NethServer management interface 2. **Enter the Proxy Domain**: Set a valid FQDN (e.g., `proxy.nethserver.org`) - This domain must have a valid DNS A/AAAA record pointing to your public IP - External VoIP devices and remote offices will use this domain to reach your system -3. **Select Network Interface**: Choose the network interface that will handle VoIP traffic from the dropdown menu +3. **Request SSL Certificate**: + - Enable Let's Encrypt to automatically manage SSL certificates for the proxy domain + - This requires the DNS record to be publicly resolvable +4. **Select Network Interface**: Choose the network interface that will handle VoIP traffic from the dropdown menu - Typically the interface connected to your WAN/Internet -4. **Configure Public IP Address**: +5. **Configure Public IP Address**: - Enter the public IPv4 or IPv6 address if different from the interface IP - This is necessary if your node is behind a router/NAT - Leave blank if the interface has a direct public IP address -5. **Request SSL Certificate**: - - Enable Let's Encrypt if you want automatic SSL certificate management - - Requires the DNS record to be publicly resolvable ### Configuration Example {#configuration-example} @@ -154,14 +151,6 @@ If your node has multiple public IP addresses, configure the proxy with the spec 2. Enter the specific public IP in the "Public IP Address" field 3. Ensure DNS records point to this IP address -### Next Steps {#next-steps} - -Once NethVoice Proxy is fully configured and running: - -1. **Verify proxy is operational**: Check the proxy status in the NethServer management interface -2. **Proceed to install NethVoice**: See [NethVoice Installation](../install/nethvoice_install.md) -3. **Configure NethVoice instances**: Each instance requires separate configuration with dedicated FQDNs - :::info Network Diagram ``` External Users/Trunks @@ -177,5 +166,3 @@ External Users/Trunks The proxy acts as a gateway between external VoIP traffic and internal NethVoice instances. ::: - -Now, you can install and configure one or more NethVoice instances. See [NethVoice Installation](../install/nethvoice_install.md) for detailed steps. diff --git a/docs/administrator-manual/configuration/index.md b/docs/administrator-manual/configuration/index.md index 50e7ef1..a1f4e98 100644 --- a/docs/administrator-manual/configuration/index.md +++ b/docs/administrator-manual/configuration/index.md @@ -12,6 +12,7 @@ The Configuration section contains documentation for managing and monitoring you - **[Wizard](./configuration/wizard)** - Access the configuration wizard for system setup and customization - **[Dashboard](./configuration/dashboard)** - Monitor system status, users, and presence information - **[Applications](./configuration/applications/)** - Configure additional NethVoice applications and integrations +- **[NethServer 8 module](../install/nethvoice_install.md#module-configuration)** - Configure the NethVoice module :::info Getting Started For the initial NethVoice setup, start with the [configuration wizard](./configuration/wizard). diff --git a/docs/administrator-manual/index.md b/docs/administrator-manual/index.md index 5a91d1b..c162a3b 100644 --- a/docs/administrator-manual/index.md +++ b/docs/administrator-manual/index.md @@ -20,7 +20,7 @@ This documentation covers the complete installation, configuration, and manageme Get started quickly by jumping to the most important sections: - **[Installation Guide](./install/index.md)** - Complete setup instructions from NethServer prerequisites to NethVoice deployment -- **[Configuration](./configuration/index.md)** - CTI, extensions, and user administration +- **[Configuration](./configuration/index.md)** - NethVoice management after the initial setup. - **[Phone Provisioning](./provisioning/index.md)** - Automated phone device management and provisioning - **[Advanced Resources](./advanced/index.md)** - System configuration and advanced topics @@ -98,9 +98,7 @@ Before deploying NethVoice, ensure you have: 1. **[Review System Requirements](./install/nethserver.md#system-requirements)** - Ensure your infrastructure meets requirements 2. **[Install NethServer 8](./install/nethserver.md)** - Deploy the base infrastructure platform -3. **[Create User Domain](./install/nethserver.md#user-domains)** - Set up LDAP for users and authentication -4. **[Install & Configure NethVoice Proxy](./advanced/nethvoice_proxy.md)** - Deploy the external VoIP gateway (REQUIRED before NethVoice) -5. **[Deploy NethVoice](./install/nethvoice_install.md)** - Install NethVoice module(s) on top of the proxy +3. **[Install & Configure NethVoice](./install/nethvoice_install.md)** - Install NethVoice Proxy and NethVoice modules 6. **Configure Your System**: - [Provision Phones](./provisioning/index.md) - Deploy and configure telephone devices - [Manage Extensions](../user-manual/nethcti/index.md) - Create extensions and assign to users diff --git a/docs/administrator-manual/install/index.md b/docs/administrator-manual/install/index.md index a535ec5..38af2bb 100644 --- a/docs/administrator-manual/install/index.md +++ b/docs/administrator-manual/install/index.md @@ -9,23 +9,10 @@ This section covers the complete installation process for NethVoice, from settin ## Overview {#overview} -NethVoice installation is a multi-step process: +NethVoice installation is a two-step process: 1. **[NethServer 8 Installation](nethserver.md)** - Install the NethServer 8 base platform -2. **[Create User Domain](nethserver.md#user-domains)** - Set up LDAP for users and authentication (in NethServer) -3. **[NethVoice Proxy Installation & Configuration](../advanced/nethvoice_proxy.md)** - Install and configure the external VoIP gateway (REQUIRED first) -4. **[NethVoice Installation](nethvoice_install.md)** - Install NethVoice on top of configured proxy -5. **[Module Configuration](nethvoice_install.md#module-configuration)** - Configure NethVoice with your requirements - -:::warning Installation Order -1. NethServer 8 must be installed first -2. User Domain must be created second (required by NethVoice) -3. NethVoice Proxy must be installed and configured third -4. NethVoice can only be installed after proxy is ready -5. NethVoice configuration uses the user domain created in step 2 - -See [NethVoice Proxy Installation](../advanced/nethvoice_proxy.md) for details on proxy requirements. -::: +2. **[NethVoice Installation](nethvoice_install.md)** - Install and configure NethVoice application ## What is NethServer 8? {#what-is-nethserver-8} @@ -62,43 +49,15 @@ Follow the [NethServer Installation guide](nethserver.md) to: - Access the web administration interface - Create your cluster -### Step 3: Create User Domain {#step-3-create-user-domain} - -Create a user domain for NethVoice users and extensions: -- Access NethServer 8 web interface → Domains and users -- Create domain (OpenLDAP recommended for NethVoice) -- Set admin credentials -- Note LDAP bind settings (needed for NethVoice configuration) - -See [User Domains setup](nethserver.md#user-domains) in the NethServer Installation guide for details. - -### Step 4: Install NethVoice Proxy {#step-4-install-nethvoice-proxy} - -After NethServer 8 and user domain are ready, install and configure the VoIP proxy: -- Access the Software Center -- Install NethVoice Proxy -- Configure proxy domain (FQDN) -- Set network interface and public IP -- Verify proxy is running - -See [NethVoice Proxy Installation Guide](../advanced/nethvoice_proxy.md) for detailed steps. - -### Step 5: Install NethVoice {#step-5-install-nethvoice} - -With NethVoice Proxy configured and running: -- Access the Software Center -- Install NethVoice -- Complete the NethVoice configuration wizard -- Select the user domain created in Step 3 -- Set up virtual hosts and certificates - -### Step 6: Configure NethVoice {#step-6-configure-nethvoice} +### Step 3: Install and configure NethVoice {#step-5-install-nethvoice} Follow the [NethVoice Installation guide](nethvoice_install.md) to: -- Configure NethVoice virtual hosts -- Verify user domain is selected -- Configure Let's Encrypt certificates -- Access NethVoice administration and CTI +- 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 {#quick-reference} @@ -149,6 +108,19 @@ Complete guide covering: - Cluster configuration - Troubleshooting +### [NethVoice Installation](nethvoice_install.md) {#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](../advanced/nethvoice_proxy.md) {#nethvoice-proxy-installation} Complete guide covering: @@ -160,18 +132,6 @@ Complete guide covering: - Verification and testing - Must be installed BEFORE NethVoice -### [NethVoice Installation](nethvoice_install.md) {#nethvoice-installation} - -Complete guide covering: -- Installation order (Proxy → NethVoice) -- NethVoice software installation -- Module configuration -- Virtual host setup -- User domain configuration -- Let's Encrypt certificate configuration -- Administrator access -- Initial configuration - ## Installation Checklist {#installation-checklist} Before you begin, ensure: @@ -185,17 +145,6 @@ Before you begin, ensure: - [ ] Internet connection is stable - [ ] You have administrative access to the server -During installation, ensure you complete: - -- [ ] NethServer 8 installation -- [ ] User Domain creation (OpenLDAP recommended) -- [ ] Note down LDAP bind settings -- [ ] NethVoice Proxy installation -- [ ] NethVoice Proxy configuration -- [ ] Verify proxy is running before NethVoice install -- [ ] NethVoice installation -- [ ] NethVoice configuration with user domain - ## Important Notes {#important-notes} :::info diff --git a/docs/administrator-manual/install/nethserver.md b/docs/administrator-manual/install/nethserver.md index 0084c39..bb1d7e8 100644 --- a/docs/administrator-manual/install/nethserver.md +++ b/docs/administrator-manual/install/nethserver.md @@ -142,61 +142,8 @@ More info available in the [official NethServerdocumentation](https://docs.neths After cluster setup, you can: -1. **Install User Domain**: [Set up LDAP or Active Directory](#user-domains) -2. **Install NethVoice**: Proceed with [NethVoice installation](nethvoice_install) via the Software Center -3. **Register NethServer**: Activate your [Enterprise subscription](#register-nethserver) - - -## User Domains {#user-domains} - -User domains store users and groups in an LDAP database. NethVoice requires at least one user domain to manage extensions, users, and authentication. - -### Overview {#overview} - -NethServer 8 supports two types of LDAP account providers: - -| Provider | Type | Best For | Features | -|----------|------|----------|----------| -| **OpenLDAP (RFC2307)** | Internal | Unix/Linux clients, simple setup | Lightweight, easy configuration, smaller deployments, multiple instances per node | -| **Active Directory (Samba)** | Internal | Windows clients, SMB file sharing | Domain controller, Windows compatibility, higher complexity, one instance per node | -| **External LDAP** | External | Existing LDAP infrastructure | Connect to existing servers (Active Directory, OpenLDAP, etc.) | - - -:::info NethVoice Requirement -NethVoice requires at least one configured user domain. Choose **OpenLDAP (RFC2307)** for simpler deployments or **Active Directory** if you need Windows client support. -::: - -### Quick Setup: OpenLDAP (Recommended for NethVoice) {#quick-setup-openldap-recommended-for-nethvoice} - -OpenLDAP is the simplest option for NethVoice-only deployments: - -1. **Access the NethServer 8 web interface** after installation completes -2. **Navigate to Domains and users** section -3. **Click "Create domain"** and choose **"Internal"** -4. **Select "OpenLDAP"** as the provider -5. **Enter domain name** (e.g., `nethvoice.local`) - this is a logical name, not DNS-related -6. **Set OpenLDAP admin username and password** -7. **Click "Install provider"** - -The domain will be ready immediately. You can now: -- Create users and groups for NethVoice extensions -- Manage user authentication -- Configure NethVoice to use this domain - -:::tip -Keep the OpenLDAP admin credentials in a secure location. You'll need them for administrative tasks. -::: - - -For advanced scenarios (external LDAP, Active Directory, DNS setup, password policies, user management), see the [official NethServer 8 User Domains documentation](https://docs.nethserver.org/projects/ns8/en/latest/user_domains.htm). - -Key topics in the official docs: -- **Active Directory Setup**: Complete domain controller configuration -- **External LDAP Connection**: Binding to existing LDAP servers -- **Password Policies**: Age, strength, and expiration settings -- **User Management Portal**: Self-service password changes -- **LDAP Provider Replicas**: Fault tolerance and redundancy -- **LDAP binding settings**: Connect external application to a local-running LDAP server +1. **Install NethVoice**: Proceed with [NethVoice installation](nethvoice_install) via the Software Center +2. **Register NethServer**: Activate your [Enterprise subscription](#register-nethserver) ## Register NethServer {#register-nethserver} diff --git a/docs/administrator-manual/install/nethvoice_install.md b/docs/administrator-manual/install/nethvoice_install.md index 4d96299..b0ed31f 100644 --- a/docs/administrator-manual/install/nethvoice_install.md +++ b/docs/administrator-manual/install/nethvoice_install.md @@ -13,17 +13,60 @@ If you want a ready-to-use NethVoice installation, please consider: - a **[VoiceBox Appliance](voicebox.md)**, a hardware appliance with NethServer and NethVoice pre-installed ::: -## Overview {#overview} +## Module Installation {#module-installation} -NethVoice is installed in two steps: +1. **Access the Software Center** on your NethServer 8 system. +2. **Search for "NethVoice"** in the Software Center search bar. +3. **Click "Install"** next to NethVoice. +4. **Wait for installation** to complete (this may take a few minutes). + +## First setup wizard {#setup-wizard} + +Open the NethVoice application from the **Applications** page or from the **Application Drawer** in NethServer 8. A first-time configuration wizard will appear and guide you through: +- Configuring an account provider for NethVoice +- Installing and configuring the NethVoice Proxy +- Configuring the NethVoice application + +### Account Provider + +The first step of the setup wizard help you configure the user domain used by NethVoice. + +User domains store users and groups in an LDAP database. NethVoice requires a user domain to manage extensions, users, and authentication. +NethServer 8 supports two types of LDAP account providers: + +| Provider | Type | Best For | Features | +|----------|------|----------|----------| +| **OpenLDAP (RFC2307)** | Internal | Unix/Linux clients, simple setup | Lightweight, easy configuration, smaller deployments, multiple instances per node | +| **Active Directory (Samba)** | Internal | Windows clients, SMB file sharing | Domain controller, Windows compatibility, higher complexity, one instance per node | +| **External LDAP** | External | Existing LDAP infrastructure | Connect to existing servers (Active Directory, OpenLDAP, etc.) | + + +:::info NethVoice Requirement +NethVoice requires at least one configured user domain. Choose **OpenLDAP (RFC2307)** for simpler deployments or **Active Directory** if you need Windows client support. +::: + +#### Quick Setup: OpenLDAP (Recommended for NethVoice) {#quick-setup-openldap-recommended-for-nethvoice} + +The setup wizard lets you quickly and easily install an OpenLDAP account provider. To configure it, you have to: -1. **NethVoice Proxy** (required first) -2. **NethVoice** module(s) +- **Enter domain name** (e.g., `nethvoice.local`) - this is a logical name, not DNS-related +- **Set OpenLDAP admin username and password** -The NethVoice Proxy is a mandatory component that must be installed and configured **before** deploying NethVoice instances. This applies even if you are installing only a single NethVoice instance. +For advanced scenarios (external LDAP, Active Directory, DNS setup, password policies, user management), see the [official NethServer 8 User Domains documentation](https://docs.nethserver.org/projects/ns8/en/latest/user_domains.htm). -:::warning Installation Order -**NethVoice Proxy must be installed FIRST, before NethVoice.** +Key topics in the official docs: +- **Active Directory Setup**: Complete domain controller configuration +- **External LDAP Connection**: Binding to existing LDAP servers +- **Password Policies**: Age, strength, and expiration settings +- **User Management Portal**: Self-service password changes +- **LDAP Provider Replicas**: Fault tolerance and redundancy +- **LDAP binding settings**: Connect external application to a local-running LDAP server + +### NethVoice Proxy + +The next step of the first setup wizard installs and configures the NethVoice Proxy. + +NethVoice Proxy is a component that must be installed and configured before deploying NethVoice application instances. Even with a single NethVoice installation, the proxy is essential for proper network traffic management. The proxy handles all external internet access and manages SIP/RTP traffic routing. It is required for: - External access from the internet @@ -31,120 +74,107 @@ The proxy handles all external internet access and manages SIP/RTP traffic routi - Managing SIP and RTP connections for all NethVoice instances - SSL/TLS termination for internet-facing VoIP traffic -Even with a single NethVoice installation, the proxy is essential for proper network traffic management. -::: +NethVoice Proxy is a standard NethServer 8 application: its settings can be reviewed and changed by accessing it from the **Application drawer** or from the **Applications** page. -## Installation Steps {#installation-steps} - -### Step 1: Install NethVoice Proxy {#step-1-install-nethvoice-proxy} - -1. **Access the Software Center** on your NethServer 8 system. -2. **Search for "NethVoice Proxy"** in the Software Center search bar. -3. **Click "Install"** next to NethVoice Proxy. -4. **Wait for installation** to complete (this may take a few minutes). -5. **Proceed to proxy configuration** before moving to the next step (see [NethVoice Proxy Configuration](#step-2-configure-nethvoice-proxy)). +#### Prerequisites -:::tip Important -Ensure NethVoice Proxy is fully installed and configured with proper FQDNs and DNS records before proceeding to install NethVoice instances. -::: +Before configuring NethVoice Proxy, ensure: -### Step 2: Configure NethVoice Proxy {#step-2-configure-nethvoice-proxy} +1. **DNS Records Created**: Create a DNS A/AAAA record for the proxy domain (e.g., `proxy.nethserver.org`) pointing to your public IP address +2. **Public IP Address**: Know the public IPv4 or IPv6 address where the proxy will be accessible from the internet +3. **Network Interface**: Identify which network interface will handle VoIP traffic -Before installing NethVoice, you must configure the NethVoice Proxy: +The setup wizard detects automatically if there already is a proxy on the installation node of NethVoice and proposes to install it if needed. Then, to configure the NethVoice Proxy: -1. **Configure the proxy domain** this is the public FQDN where the proxy will be reachable. +1. **Configure the Proxy domain** this is the public FQDN where the proxy will be reachable. Do not enter NethServer FQDN but use a dedicated one, like `proxy.nethserver.org`. This name will be used by external clients to reach your VoIP services, but it will not be used directly by final users. -2. **Set the network interface** that will handle VoIP traffic -3. **Configure public IP address** if different from the interface IP +2. **Enable Request Let's Encrypt certificate** checkbox if needed: a Let's Encrypt certificate will be requested for the proxy domain. +3. **Set the Network interface** that will handle VoIP traffic +4. **Configure Public IP address** if different from the interface IP -Above configuration will be the entry point for all external VoIP traffic. +Above configuration will be the entrypoint for all external VoIP traffic. Make sure that: - the configured FQDN resolves correctly to the public IP address - any DNS records are properly set up to point to the proxy -Those requeirements are critical to obtain a valid SSL/TLS certificate for secure communications. +These requirements are critical to obtain a valid SSL/TLS certificate for secure communications. See [NethVoice Proxy Documentation](../advanced/nethvoice_proxy.md) for more info. -### Step 3: Install NethVoice {#step-3-install-nethvoice} +### NethVoice application -Once the NethVoice Proxy is running, you can install NethVoice instances: - -1. **Return to Software Center** on your NethServer 8 system. -2. **Search for "NethVoice"** in the Software Center search bar. -3. **Click "Install"** next to NethVoice. -4. **Wait for installation** to complete. -5. **Proceed with Module Configuration** as described in the next section. -6. **Access the NethVoice instance** and follow the initial configuration wizard to complete the setup. +:::warning DNS configuration +To set up NethVoice, you need to have two dedicated virtual hosts: -:::info Multiple Instances -You can install multiple NethVoice instances on the same node. Each will use the shared NethVoice Proxy for external access and traffic routing. Each instance requires separate configuration and dedicated FQDNs. -::: +- A **NethVoice base host** for the NethVoice administration interface, eg. `nethvoice.nethserver.org` +- A **NethVoice CTI base host** for the NethVoice CTI web application, eg. `cti.nethserver.org` +Before proceeding with the configuration, ensure that you have created the corresponding DNS records for these FQDNs in your DNS server. -## Module Configuration {#module-configuration} +If you plan to use a Let's Encrypt certificate as the default certificate, make sure you have the necessary public DNS records. +::: -:::warning Required Prerequisites -Before proceeding with the configuration of any NethVoice instance, ensure: +In the last step of the setup wizard, you will be prompted to provide the following information: -1. **NethVoice Proxy is installed** - See [NethVoice Proxy Installation](../advanced/nethvoice_proxy.md) -2. **NethVoice Proxy is configured** - Proxy domain (FQDN) must be set and DNS records created -3. **NethVoice Proxy is running** - Verify proxy status in the node management interface -4. **User Domain is created** - See [User Domains in NethServer Installation](./nethserver.md#user-domains) (required for NethVoice users and extensions) +- **NethVoice base host**: Enter a valid FQDN to access the application administration page; this is where you will manage NethVoice settings, e.g. `nethvoice.nethserver.org`. +- **NethVoice CTI base host**: Enter a valid FQDN for the NethVoice CTI web application, e.g. `cti.nethserver.org`. +- **Request Let's Encrypt certificate**: If enabled, a Let's Encrypt certificate will be requested for both the **NethVoice base host** and the **NethVoice CTI base host**. +- **Timezone**: Select the appropriate timezone for your NethVoice application; this is important for accurate call logging and scheduling. +- **Admin password to access user interface**: Sets the password for the NethVoice administration page. -The NethVoice module requires at least one user domain to manage users, extensions, and authentication. If you haven't created a user domain yet, follow the [User Domains setup guide](./nethserver.md#user-domains) before configuring NethVoice. -::: +### Next steps {#next-steps} +At the end of the first-time configuration wizard, NethVoice will be accessible on the base host configured, e.g.: +``` +https://nethvoice.nethserver.org +``` -To set up NethVoice, you need to have two dedicated virtual hosts: +To access the NethVoice administration interface, use the following credentials: -- one for the NethVoice administration page, eg. `nethvoice.nethserver.org` -- one for the NethVoice CTI web application, eg. `cti.nethserver.org` +- User: `admin` +- Password: `Nethesis,1234`, the default password if the *Reset NethVoice admin password to access user interface* option was not used during the configuration +After completing NethVoice configuration in the administration interface, users can access NethVoice CTI on the base host configured, e.g.: +``` +https://cti.nethserver.org +``` -Before proceeding with the configuration, ensure that you have created the corresponding DNS records for these FQDNs in your DNS server. +## Module Configuration {#module-configuration} -If you plan to use a Let's Encrypt certificate as the default certificate, make sure you have the necessary public DNS records. +The settings of the NethVoice module can be reviewew and changed by accessing the NethVoice module of NethServer 8. To do this: -During the module configuration wizard, you will be prompted to provide the following information: +- Access the NethServer cluster administration page. +- Open the NethVoice application from the **Application drawer** or from the **Applications** page. +- Go to the specific configuration page you want to modify. -- **NethVoice base host**: Insert a valid FQDN to access the application administration page, this is where you will manage NethVoice settings, eg. `nethvoice.nethserver.org`. -- **NethVoice CTI base host**: Insert a valid FQDN to access the NethVoice CTI web application, eg. `cti.nethserver.org`. -- **User Domain**: Choose one of the [user domains](./nethserver.md#user-domains) already configured. -- **Timezone**: Select the appropriate timezone for your NethVoice instance, this is important for accurate call logging and scheduling. -- **Request Let's Encrypt certificate**: If enabled, a Let's Encrypt certificate will be requested for each of the two hosts. -- **Reports Prefix**: Insert the international telephone prefix to be considered local in the reporting system. -- **Reset NethVoice admin password to access user interface**: Insert a valid password for the NethVoice administrator user (optional, the default password is *Nethesis,1234*). +On the **Settings** page you can review and change most of the configuration parameters: -Advanced configuration options: +- **NethVoice base host**: virtual host for the NethVoice administration interface. +- **NethVoice CTI base host**: virtual host for NethVoice CTI web application. +- **Request Let's Encrypt certificate**: if enabled, a Let's Encrypt certificate will be requested for both the **NethVoice base host** and the **NethVoice CTI base host**. +- **Account provider**: user domain used by NethVoice. +- **Timezone**: timezone for your NethVoice application, this is important for accurate call logging and scheduling. +- **Reports prefix**: telephone prefix number used in reports +- **New admin password for NethVoice**: define a new password for the `admin` user -- **Deepgram API Key**: Insert your Deepgram API key to enable advanced speech recognition features and voice transcription. - - **Enable call transcription**: Enable this option to allow users to transcribe calls in real-time using Deepgram's speech-to-text service. This feature incurs additional costs based on your Deepgram usage. - - **Voicemail transcription**: Enable voicemail transcription to convert voicemail messages to text using Deepgram. This feature also incurs additional costs based on your Deepgram usage. +On the **Integrations** page you can configure call and voicemail transcription: +- **Deepgram API Key**: Enter your Deepgram API key to enable advanced speech recognition features and voice transcription. +- **Enable call transcription**: Enable this option to allow users to transcribe calls in real-time using Deepgram's speech-to-text service. This feature incurs additional costs based on your Deepgram usage. +- **Voicemail transcription**: Enable voicemail transcription to convert voicemail messages to text using Deepgram. This feature also incurs additional costs based on your Deepgram usage. :::info Voice Transcription For detailed information on how users can access and use voice transcription features, see [Voice Transcription](../../user-manual/nethcti/other.md#voice-transcription) in the User Manual. ::: -The following options are available only with an active Enterprise subscription: +On the **Rebranding** page you can customize the NethVoice user interface with the brand identity of your company. To enable this feature, you have to contact Nethesis sales team and an have active Enterprise subscription. + +On the **Hotel** page you can configure the Hotel module; an active subscription is required for this feature. -- **Enable Hotel module**: Activate the Hotel module for managing hotel-specific telephony features. - See [NethVoice Hotel Module Documentation](/docs/administrator-manual/nethhotel/index.md) for more details. +- **Status**: Activate the Hotel module for managing hotel-specific telephony features. - **Hotel FIAS server host**: Enter the IP address or hostname of the Hotel FIAS server. - **Hotel FIAS server port**: Specify the port number for the Hotel FIAS server connection. -## Next steps {#next-steps} - -After saving the configuration parameters, NethVoice will be accessible on its base host, eg: -``` -https://nethvoice.nethserver.org -``` - -To access the NethVoice administration interface, use the following credentials: - -- User: `admin` -- Password: `Nethesis,1234`, the default password if the *Reset NethVoice admin password to access user interface* option was not used during the configuration - +See [NethVoice Hotel Module Documentation](/docs/administrator-manual/nethhotel/index.md) for more details. From 20d0f8cb92bc3c3fd8369deb370b16d2aa876de5 Mon Sep 17 00:00:00 2001 From: Translation Sync Bot Date: Tue, 13 Jan 2026 14:05:25 +0000 Subject: [PATCH 02/22] docs: auto-sync translations for PR #33 --- .../advanced/nethvoice_proxy.md | 75 ++++++------- .../configuration/index.md | 3 +- .../current/administrator-manual/index.md | 14 +-- .../administrator-manual/install/index.md | 103 +++++------------- .../install/nethserver.md | 2 + 5 files changed, 66 insertions(+), 131 deletions(-) diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/advanced/nethvoice_proxy.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/advanced/nethvoice_proxy.md index 2793a55..3540bc2 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/advanced/nethvoice_proxy.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/advanced/nethvoice_proxy.md @@ -69,30 +69,25 @@ In questo scenario: ## Installazione -:::note -Puoi installare solo un NethVoice Proxy per nodo dal Software Center. -::: +### Installazione consigliata: {#installation-steps} -NethVoice Proxy deve essere installato **prima** di distribuire qualsiasi istanza di NethVoice. Vedi [Installazione di NethVoice](../install/nethvoice_install.md) per la sequenza di installazione completa. +NethVoice Proxy viene installato come parte della procedura guidata di configurazione del modulo NethVoice. Consultare [Installazione di NethVoice](../install/nethvoice_install.md) per la sequenza completa di installazione. -### Passaggi di installazione +### Installazione manuale (non consigliata): -1. **Apri l'interfaccia di gestione di NethServer** sul tuo nodo -2. **Naviga a Software Center** -3. **Cerca "NethVoice Proxy"** -4. **Fai clic su "Installa"** e attendi il completamento dell'installazione -5. **Procedi alla configurazione** (vedi la sezione sottostante) - -:::warning Ordine di installazione -Non tentare di installare NethVoice prima di installare e configurare NethVoice Proxy. L'installazione non riuscirà se il proxy non è disponibile. +:::note +È possibile installare un solo NethVoice Proxy per nodo dal Software Center. +::: -## Configurazione +NethVoice Proxy deve essere installato **prima** di distribuire qualsiasi istanza di NethVoice. -La configurazione di NethVoice Proxy è essenziale prima di installare le istanze di NethVoice. Il proxy richiede un FQDN dedicato e impostazioni di rete appropriate. +1. **Aprire l'interfaccia di gestione di NethServer** sul proprio nodo +2. **Navigare al Software Center** +3. **Selezionare "NethVoice Proxy"** dall'elenco dei pacchetti disponibili +4. **Fare clic su "Installa"** e attendere il completamento dell'installazione +5. **Procedere alla configurazione** (vedere la sezione seguente) -:::warning Configurazione richiesta -NethVoice Proxy deve essere completamente configurato e operativo prima di installare le istanze di NethVoice. Verifica che la configurazione sia completa e che il proxy sia in esecuzione prima di procedere all'installazione di NethVoice. -::: +## Configurazione ### Prerequisiti @@ -102,21 +97,23 @@ Prima di configurare NethVoice Proxy, assicurati che: 2. **Indirizzo IP pubblico**: Conosci l'indirizzo IPv4 o IPv6 pubblico dove il proxy sarà accessibile da Internet 3. **Interfaccia di rete**: Identifica quale interfaccia di rete gestirà il traffico VoIP -### Passaggi di configurazione - -1. **Accedi alla pagina di configurazione del proxy** nell'interfaccia di gestione di NethServer -2. **Inserisci il dominio proxy**: Imposta un FQDN valido (ad es. `proxy.nethserver.org`) - - Questo dominio deve avere un record DNS A/AAAA valido che punta al tuo IP pubblico - - I dispositivi VoIP esterni e gli uffici remoti utilizzeranno questo dominio per raggiungere il tuo sistema -3. **Seleziona interfaccia di rete**: Scegli l'interfaccia di rete che gestirà il traffico VoIP dal menu a discesa - - Tipicamente l'interfaccia collegata alla tua WAN/Internet -4. **Configura indirizzo IP pubblico**: - - Immetti l'indirizzo IPv4 o IPv6 pubblico se diverso dall'IP dell'interfaccia - - Questo è necessario se il tuo nodo è dietro un router/NAT - - Lascia vuoto se l'interfaccia ha un indirizzo IP pubblico diretto -5. **Richiedi certificato SSL**: - - Abilita Let's Encrypt se desideri la gestione automatica dei certificati SSL - - Richiede che il record DNS sia risolvibile pubblicamente +### Passaggi di configurazione {#configuration-steps} + +NethVoice Proxy viene solitamente configurato durante la procedura guidata di configurazione di un modulo NethVoice (consultare [Installazione di NethVoice](../install/nethvoice_install.md) per la sequenza completa di installazione). Per rivedere o modificare la configurazione del proxy: + +1. **Accedere alla pagina di configurazione del proxy** nell'interfaccia di gestione di NethServer +2. **Inserire il dominio del proxy**: Impostare un FQDN valido (es. `proxy.nethserver.org`) + - Questo dominio deve avere un record DNS A/AAAA valido che punti al proprio IP pubblico + - I dispositivi VoIP esterni e gli uffici remoti utilizzeranno questo dominio per raggiungere il sistema +3. **Richiedere il certificato SSL**: + - Abilitare Let's Encrypt per gestire automaticamente i certificati SSL per il dominio del proxy + - Questo richiede che il record DNS sia risolvibile pubblicamente +4. **Selezionare l'interfaccia di rete**: Scegliere l'interfaccia di rete che gestirà il traffico VoIP dal menu a tendina + - Tipicamente l'interfaccia connessa alla rete WAN/Internet +5. **Configurare l'indirizzo IP pubblico**: + - Inserire l'indirizzo IPv4 o IPv6 pubblico se diverso dall'IP dell'interfaccia + - Questo è necessario se il nodo si trova dietro un router/NAT + - Lasciare vuoto se l'interfaccia ha un IP pubblico diretto ### Esempio di configurazione @@ -154,14 +151,6 @@ Se il tuo nodo ha più indirizzi IP pubblici, configura il proxy con l'IP pubbli 2. Inserisci l'IP pubblico specifico nel campo "Indirizzo IP pubblico" 3. Assicurati che i record DNS puntino a questo indirizzo IP -### Passaggi successivi - -Una volta che NethVoice Proxy è completamente configurato e in esecuzione: - -1. **Verifica che il proxy sia operativo**: Controlla lo stato del proxy nell'interfaccia di gestione di NethServer -2. **Procedi all'installazione di NethVoice**: Vedi [Installazione di NethVoice](../install/nethvoice_install.md) -3. **Configura istanze di NethVoice**: Ogni istanza richiede una configurazione separata con FQDN dedicati - :::info Diagramma di rete ``` Utenti/Trunk esterni @@ -176,6 +165,4 @@ Utenti/Trunk esterni ``` Il proxy agisce come gateway tra il traffico VoIP esterno e le istanze interne di NethVoice. -::: - -Ora puoi installare e configurare una o più istanze di NethVoice. Vedi [Installazione di NethVoice](../install/nethvoice_install.md) per i passaggi dettagliati. +::: \ No newline at end of file diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/configuration/index.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/configuration/index.md index 51eb219..595f423 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/configuration/index.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/configuration/index.md @@ -12,7 +12,8 @@ La sezione Configurazione contiene documentazione per la gestione e il monitorag - **[Procedura guidata](./configuration/wizard)** - Accedi alla procedura guidata di configurazione per la configurazione e la personalizzazione del sistema - **[Dashboard](./configuration/dashboard)** - Monitora lo stato del sistema, gli utenti e le informazioni di presenza - **[Applicazioni](./configuration/applications/)** - Configura applicazioni e integrazioni aggiuntive di NethVoice +- **[Modulo NethServer 8](../install/nethvoice_install.md#module-configuration)** - Configurare il modulo NethVoice :::info Per iniziare Per la configurazione iniziale di NethVoice, inizia con la [procedura guidata di configurazione](./configuration/wizard). -::: +::: \ No newline at end of file diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/index.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/index.md index 9fbae31..eb65572 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/index.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/index.md @@ -20,11 +20,10 @@ Questa documentazione copre l'installazione completa, la configurazione e la ges Iniziate velocemente passando alle sezioni più importanti: - **[Guida all'Installazione](./install/index.md)** - Istruzioni complete per l'installazione, dai prerequisiti di NethServer al deployment di NethVoice -- **[Configurazione](./configuration/index.md)** - CTI, interni e gestione utenti +- **[Configurazione](./configuration/index.md)** - Gestione di NethVoice dopo la configurazione iniziale. - **[Provisioning Telefoni](./provisioning/index.md)** - Gestione automatica dei dispositivi telefonici e provisioning - **[Risorse Avanzate](./advanced/index.md)** - Configurazione di sistema e argomenti avanzati - ## Componenti Principali NethVoice è costruito su sette principali componenti open-source: @@ -99,13 +98,11 @@ Prima di distribuire NethVoice, assicuratevi di avere: 1. **[Verificare i Requisiti di Sistema](./install/nethserver.md#system-requirements)** - Assicuratevi che la vostra infrastruttura soddisfi i requisiti 2. **[Installare NethServer 8](./install/nethserver.md)** - Distribuire la piattaforma infrastruttura base -3. **[Creare Dominio Utente](./install/nethserver.md#user-domains)** - Configurare LDAP per utenti e autenticazione -4. **[Installare e Configurare Proxy NethVoice](./advanced/nethvoice_proxy.md)** - Distribuire il gateway VoIP esterno (RICHIESTO prima di NethVoice) -5. **[Distribuire NethVoice](./install/nethvoice_install.md)** - Installare il modulo NethVoice sopra il proxy -6. **Configurare il Vostro Sistema**: +3. **[Installa e configura NethVoice](./install/nethvoice_install.md)** - Installa il Proxy NethVoice e i moduli NethVoice. +4. **Configurare il Vostro Sistema**: - [Provisioning Telefoni](./provisioning/index.md) - Distribuire e configurare dispositivi telefonici - [Gestire Interni](../user-manual/nethcti/index.md) - Creare interni e assegnare agli utenti -7. **[Configurazione Avanzata](./advanced/index.md)** - Configurare trunk, gateway, instradamento e funzionalità avanzate +5. **[Configurazione Avanzata](./advanced/index.md)** - Configurare trunk, gateway, instradamento e funzionalità avanzate ## Sezioni Documentazione Principale @@ -192,5 +189,4 @@ Nethesis offre una suite completa di soluzioni ICT modulari e indipendenti che r - **[NethSpot](https://www.nethesis.it/soluzioni/nethspot)** — Gestione hotspot WiFi pubblici. Migliora l'esperienza guest con proximity marketing, login social, gestione centralizzata del WiFi e controllo della banda. -Tutte le soluzioni sono indipendenti dalla modalità di distribuzione: installabili su appliance certificate, macchine virtuali, cloud privati o hardware compatibile. Per maggiori informazioni visitate [www.nethesis.it](https://www.nethesis.it) o contattate [marketing@nethesis.it](mailto:marketing@nethesis.it). - +Tutte le soluzioni sono indipendenti dalla modalità di distribuzione: installabili su appliance certificate, macchine virtuali, cloud privati o hardware compatibile. Per maggiori informazioni visitate [www.nethesis.it](https://www.nethesis.it) o contattate [marketing@nethesis.it](mailto:marketing@nethesis.it). \ No newline at end of file diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/index.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/index.md index f20a654..4ae8d6f 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/index.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/index.md @@ -7,25 +7,12 @@ sidebar_position: 1 Questa sezione copre il processo di installazione completo per NethVoice, dall'installazione dell'infrastruttura NethServer 8 sottostante alla configurazione di NethVoice stesso. -## Panoramica +## Panoramica {#overview} -L'installazione di NethVoice è un processo multi-passaggio: +L'installazione di NethVoice è un processo in due fasi: -1. **[Installazione di NethServer 8](nethserver.md)** - Installa la piattaforma base di NethServer 8 -2. **[Crea dominio utente](nethserver.md#user-domains)** - Configura LDAP per utenti e autenticazione (in NethServer) -3. **[Installazione e configurazione di NethVoice Proxy](../advanced/nethvoice_proxy.md)** - Installa e configura il gateway VoIP esterno (RICHIESTO per primo) -4. **[Installazione di NethVoice](nethvoice_install.md)** - Installa NethVoice sopra il proxy configurato -5. **[Configurazione del modulo](nethvoice_install.md#module-configuration)** - Configura NethVoice con i tuoi requisiti - -:::warning Ordine di installazione -1. NethServer 8 deve essere installato per primo -2. Il dominio utente deve essere creato per secondo (richiesto da NethVoice) -3. NethVoice Proxy deve essere installato e configurato per terzo -4. NethVoice può essere installato solo dopo che il proxy è pronto -5. La configurazione di NethVoice utilizza il dominio utente creato nel passaggio 2 - -Vedi [Installazione di NethVoice Proxy](../advanced/nethvoice_proxy.md) per i dettagli sui requisiti del proxy. -::: +1. **[Installazione di NethServer 8](nethserver.md)** - Installare la piattaforma base NethServer 8 +2. **[Installazione di NethVoice](nethvoice_install.md)** - Installare e configurare l'applicazione NethVoice ## Cos'è NethServer 8? @@ -62,43 +49,15 @@ Segui la [guida all'installazione di NethServer](nethserver.md) per: - Accedere all'interfaccia di amministrazione web - Creare il tuo cluster -### Passaggio 3: Crea dominio utente - -Crea un dominio utente per gli utenti e gli interni di NethVoice: -- Accedi all'interfaccia web di NethServer 8 → Domini e utenti -- Crea dominio (OpenLDAP consigliato per NethVoice) -- Imposta le credenziali di amministrazione -- Annota le impostazioni di bind LDAP (necessarie per la configurazione di NethVoice) - -Vedi [Setup dei domini utente](nethserver.md#user-domains) nella guida all'installazione di NethServer per i dettagli. - -### Passaggio 4: Installa NethVoice Proxy - -Dopo che NethServer 8 e il dominio utente sono pronti, installa e configura il proxy VoIP: -- Accedi al Software Center -- Installa NethVoice Proxy -- Configura il dominio proxy (FQDN) -- Imposta l'interfaccia di rete e l'IP pubblico -- Verifica che il proxy sia in esecuzione - -Vedi [Guida all'installazione di NethVoice Proxy](../advanced/nethvoice_proxy.md) per i passaggi dettagliati. - -### Passaggio 5: Installa NethVoice +### Passaggio 3: Installare e configurare NethVoice {#step-5-install-nethvoice} -Con NethVoice Proxy configurato e in esecuzione: -- Accedi al Software Center -- Installa NethVoice -- Completa la procedura guidata di configurazione di NethVoice -- Seleziona il dominio utente creato nel Passaggio 3 -- Configura gli host virtuali e i certificati - -### Passaggio 6: Configura NethVoice - -Segui la [guida all'installazione di NethVoice](nethvoice_install.md) per: -- Configurare gli host virtuali di NethVoice -- Verificare che il dominio utente sia selezionato -- Configurare i certificati Let's Encrypt -- Accedere all'amministrazione e CTI di NethVoice +Segui la [Guida all'installazione di NethVoice](nethvoice_install.md) per: +- Installare NethVoice +- Completare la configurazione guidata: + - Configurare un provider di account + - Installare e configurare un NethVoice Proxy + - Configurare virtual host, certificati e password di amministrazione +- Accedere all'interfaccia di amministrazione di NethVoice e CTI ## Riferimento veloce @@ -149,6 +108,19 @@ Guida completa che copre: - Configurazione del cluster - Risoluzione dei problemi +### [Installazione di NethVoice](nethvoice_install.md) {#nethvoice-installation} + +Guida completa che copre: +- Installazione del software NethVoice +- Configurazione guidata: + - Dominio utenti + - NethVoice Proxy + - Virtual host (host base) + - Certificati Let's Encrypt + - Password di amministrazione +- Accesso amministratore +- Configurazione iniziale + ### [Installazione di NethVoice Proxy](../advanced/nethvoice_proxy.md) Guida completa che copre: @@ -160,18 +132,6 @@ Guida completa che copre: - Verifica e test - Deve essere installato PRIMA di NethVoice -### [Installazione di NethVoice](nethvoice_install.md) - -Guida completa che copre: -- Ordine di installazione (Proxy → NethVoice) -- Installazione software di NethVoice -- Configurazione del modulo -- Configurazione dell'host virtuale -- Configurazione del dominio utente -- Configurazione del certificato Let's Encrypt -- Accesso amministratore -- Configurazione iniziale - ## Elenco di controllo dell'installazione Prima di iniziare, assicurati che: @@ -185,17 +145,6 @@ Prima di iniziare, assicurati che: - [ ] La connessione Internet è stabile - [ ] Hai accesso amministrativo al server -Durante l'installazione, assicurati di completare: - -- [ ] Installazione di NethServer 8 -- [ ] Creazione del dominio utente (OpenLDAP consigliato) -- [ ] Annota le impostazioni di bind LDAP -- [ ] Installazione di NethVoice Proxy -- [ ] Configurazione di NethVoice Proxy -- [ ] Verifica che il proxy sia in esecuzione prima dell'installazione di NethVoice -- [ ] Installazione di NethVoice -- [ ] Configurazione di NethVoice con il dominio utente - ## Note importanti :::info @@ -261,4 +210,4 @@ Dopo l'installazione completata con successo: --- -**Pronto per iniziare?** Inizia con la [guida all'installazione di NethServer 8](nethserver.md). +**Pronto per iniziare?** Inizia con la [guida all'installazione di NethServer 8](nethserver.md). \ No newline at end of file diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md index 29fa990..121a8d0 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md @@ -249,3 +249,5 @@ Se hai bisogno di riconfigurare le impostazioni di rete: - **Rocky Linux**: Utilizza `nmtui` o modifica i file di NetworkManager - **Debian**: Utilizza `netplan` o `/etc/network/interfaces` - **CentOS Stream/AlmaLinux**: Utilizza `nmcli` o `nmtui` + +## Registrare NethServer {#registrare-nethserver} \ No newline at end of file From d872a7d157069af97429ca19f482c6083f052bac Mon Sep 17 00:00:00 2001 From: Andrea Leardini Date: Tue, 13 Jan 2026 15:24:37 +0100 Subject: [PATCH 03/22] fix: review by Copilot --- docs/administrator-manual/advanced/nethvoice_proxy.md | 4 ++-- docs/administrator-manual/index.md | 4 ++-- docs/administrator-manual/install/nethserver.md | 2 +- docs/administrator-manual/install/nethvoice_install.md | 10 +++++----- 4 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/administrator-manual/advanced/nethvoice_proxy.md b/docs/administrator-manual/advanced/nethvoice_proxy.md index 451fb3b..8706481 100644 --- a/docs/administrator-manual/advanced/nethvoice_proxy.md +++ b/docs/administrator-manual/advanced/nethvoice_proxy.md @@ -69,11 +69,11 @@ In this scenario: ## Installation {#installation} -### Recommended installation: {#installation-steps} +### Recommended Installation: {#installation-steps} NethVoice proxy is installed as part of the NethVoice module setup wizard. See [NethVoice Installation](../install/nethvoice_install.md) for the complete installation sequence. -### Manual installation (not recommended): +### Manual Installation (not recommended): :::note You can install only one NethVoice Proxy per node from the Software Center. diff --git a/docs/administrator-manual/index.md b/docs/administrator-manual/index.md index c162a3b..46dfe3a 100644 --- a/docs/administrator-manual/index.md +++ b/docs/administrator-manual/index.md @@ -99,10 +99,10 @@ Before deploying NethVoice, ensure you have: 1. **[Review System Requirements](./install/nethserver.md#system-requirements)** - Ensure your infrastructure meets requirements 2. **[Install NethServer 8](./install/nethserver.md)** - Deploy the base infrastructure platform 3. **[Install & Configure NethVoice](./install/nethvoice_install.md)** - Install NethVoice Proxy and NethVoice modules -6. **Configure Your System**: +4. **Configure Your System**: - [Provision Phones](./provisioning/index.md) - Deploy and configure telephone devices - [Manage Extensions](../user-manual/nethcti/index.md) - Create extensions and assign to users -7. **[Advanced Configuration](./advanced/index.md)** - Configure trunks, gateways, routing, and advanced features +5. **[Advanced Configuration](./advanced/index.md)** - Configure trunks, gateways, routing, and advanced features ## Key Documentation Sections {#key-documentation-sections} diff --git a/docs/administrator-manual/install/nethserver.md b/docs/administrator-manual/install/nethserver.md index bb1d7e8..f223e4c 100644 --- a/docs/administrator-manual/install/nethserver.md +++ b/docs/administrator-manual/install/nethserver.md @@ -137,7 +137,7 @@ After installation completes: - Password: `Nethesis,1234` Follow the wizard to create a cluster and configure the node. -More info available in the [official NethServerdocumentation](https://docs.nethserver.org/projects/ns8/en/latest/install.html#post-installation-steps). +More info available in the [official NethServer documentation](https://docs.nethserver.org/projects/ns8/en/latest/install.html#post-installation-steps). After cluster setup, you can: diff --git a/docs/administrator-manual/install/nethvoice_install.md b/docs/administrator-manual/install/nethvoice_install.md index b0ed31f..fe654a4 100644 --- a/docs/administrator-manual/install/nethvoice_install.md +++ b/docs/administrator-manual/install/nethvoice_install.md @@ -29,7 +29,7 @@ Open the NethVoice application from the **Applications** page or from the **Appl ### Account Provider -The first step of the setup wizard help you configure the user domain used by NethVoice. +The first step of the setup wizard helps you configure the user domain used by NethVoice. User domains store users and groups in an LDAP database. NethVoice requires a user domain to manage extensions, users, and authentication. NethServer 8 supports two types of LDAP account providers: @@ -94,7 +94,7 @@ The setup wizard detects automatically if there already is a proxy on the instal 3. **Set the Network interface** that will handle VoIP traffic 4. **Configure Public IP address** if different from the interface IP -Above configuration will be the entrypoint for all external VoIP traffic. +The above configuration will be the entrypoint for all external VoIP traffic. Make sure that: - the configured FQDN resolves correctly to the public IP address @@ -135,7 +135,7 @@ https://nethvoice.nethserver.org To access the NethVoice administration interface, use the following credentials: - User: `admin` -- Password: `Nethesis,1234`, the default password if the *Reset NethVoice admin password to access user interface* option was not used during the configuration +- Password: The password you have chosen in the first-time configuration wizard After completing NethVoice configuration in the administration interface, users can access NethVoice CTI on the base host configured, e.g.: ``` @@ -144,7 +144,7 @@ https://cti.nethserver.org ## Module Configuration {#module-configuration} -The settings of the NethVoice module can be reviewew and changed by accessing the NethVoice module of NethServer 8. To do this: +The settings of the NethVoice module can be reviewed and changed by accessing the NethVoice module of NethServer 8. To do this: - Access the NethServer cluster administration page. - Open the NethVoice application from the **Application drawer** or from the **Applications** page. @@ -169,7 +169,7 @@ On the **Integrations** page you can configure call and voicemail transcription: For detailed information on how users can access and use voice transcription features, see [Voice Transcription](../../user-manual/nethcti/other.md#voice-transcription) in the User Manual. ::: -On the **Rebranding** page you can customize the NethVoice user interface with the brand identity of your company. To enable this feature, you have to contact Nethesis sales team and an have active Enterprise subscription. +On the **Rebranding** page you can customize the NethVoice user interface with the brand identity of your company. To enable this feature, you have to contact Nethesis sales team and have an active Enterprise subscription. On the **Hotel** page you can configure the Hotel module; an active subscription is required for this feature. From 4ce513884bc65210833e94dfc67d0bba8b0776fd Mon Sep 17 00:00:00 2001 From: Translation Sync Bot Date: Tue, 13 Jan 2026 14:26:48 +0000 Subject: [PATCH 04/22] docs: auto-sync translations for PR #33 --- .../install/nethvoice_install.md | 163 ++++++++++++++++++ 1 file changed, 163 insertions(+) diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md index d976171..a5fb532 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md @@ -144,3 +144,166 @@ Per accedere all'interfaccia di amministrazione di NethVoice, utilizza le seguen - Utente: `admin` - Password: `Nethesis,1234`, la password predefinita se l'opzione *Ripristina la password dell'amministratore di NethVoice per accedere all'interfaccia utente* non è stata utilizzata durante la configurazione + +## Installazione del modulo {#installazione-del-modulo} + +1. **Accedi al Software Center** sul tuo sistema NethServer 8. +2. **Cerca "NethVoice"** nella barra di ricerca del Software Center. +3. **Fai clic su "Installa"** accanto a NethVoice. +4. **Attendi il completamento dell'installazione** (potrebbero essere necessari alcuni minuti). + +## Procedura guidata di configurazione iniziale {#procedura-guidata-di-configurazione} + +Apri l'applicazione NethVoice dalla **pagina Applicazioni** o dal **Cassetto delle applicazioni** in NethServer 8. Apparirà una procedura guidata di configurazione iniziale che ti guiderà attraverso: +- Configurazione di un provider di account per NethVoice +- Installazione e configurazione del Proxy NethVoice +- Configurazione dell'applicazione NethVoice + +### Provider di account {#provider-di-account} + +Il primo passaggio della procedura guidata ti aiuta a configurare il dominio utenti utilizzato da NethVoice. + +I domini utenti memorizzano utenti e gruppi in un database LDAP. NethVoice richiede un dominio utenti per gestire interni, utenti e autenticazione. +NethServer 8 supporta due tipi di provider di account LDAP: + +| Provider | Tipo | Ideale per | Funzionalità | +|----------|------|------------|--------------| +| **OpenLDAP (RFC2307)** | Interno | Client Unix/Linux, configurazione semplice | Leggero, configurazione semplice, distribuzioni di piccole dimensioni, istanze multiple per nodo | +| **Active Directory (Samba)** | Interno | Client Windows, condivisione file SMB | Controller di dominio, compatibilità Windows, maggiore complessità, una sola istanza per nodo | +| **LDAP Esterno** | Esterno | Infrastruttura LDAP esistente | Connessione a server esistenti (Active Directory, OpenLDAP, ecc.) | + +:::info Requisiti di NethVoice +NethVoice richiede almeno un dominio utenti configurato. Scegli **OpenLDAP (RFC2307)** per distribuzioni più semplici o **Active Directory** se hai bisogno di supporto per client Windows. +::: + +#### Configurazione rapida: OpenLDAP (Consigliato per NethVoice) {#configurazione-rapida-openldap-consigliato-per-nethvoice} + +La procedura guidata consente di installare facilmente un provider di account OpenLDAP. Per configurarlo, devi: + +- **Inserire il nome del dominio** (es. `nethvoice.local`) - questo è un nome logico, non correlato al DNS +- **Impostare nome utente e password dell'amministratore di OpenLDAP** + +Per scenari avanzati (LDAP esterno, Active Directory, configurazione DNS, politiche di password, gestione utenti), consulta la [documentazione ufficiale sui domini utenti di NethServer 8](https://docs.nethserver.org/projects/ns8/en/latest/user_domains.htm). + +Argomenti chiave nella documentazione ufficiale: +- **Configurazione di Active Directory**: Configurazione completa del controller di dominio +- **Connessione LDAP esterno**: Collegamento a server LDAP esistenti +- **Politiche di password**: Età, complessità e scadenza delle password +- **Portale di gestione utenti**: Modifica autonoma delle password da parte degli utenti +- **Repliche del provider LDAP**: Tolleranza ai guasti e ridondanza +- **Impostazioni di binding LDAP**: Collegamento di applicazioni esterne a un server LDAP locale + +### Proxy NethVoice {#proxy-nethvoice} + +Il passaggio successivo della procedura guidata iniziale installa e configura il Proxy NethVoice. + +Il Proxy NethVoice è un componente che deve essere installato e configurato prima di distribuire le istanze dell'applicazione NethVoice. Anche con una sola installazione di NethVoice, il proxy è essenziale per una corretta gestione del traffico di rete. + +Il proxy gestisce tutto l'accesso esterno a Internet e il routing del traffico SIP/RTP. È necessario per: +- Accesso esterno da Internet +- Gestione delle connessioni SIP e RTP per tutte le istanze di NethVoice +- Terminazione SSL/TLS per il traffico VoIP esposto a Internet + +Il Proxy NethVoice è un'applicazione standard di NethServer 8: le sue impostazioni possono essere riviste e modificate accedendo dal **Cassetto delle applicazioni** o dalla **pagina Applicazioni**. + +#### Prerequisiti {#prerequisiti} + +Prima di configurare il Proxy NethVoice, assicurati che: + +1. **Record DNS creati**: Crea un record DNS A/AAAA per il dominio del proxy (es. `proxy.nethserver.org`) che punti al tuo indirizzo IP pubblico +2. **Indirizzo IP pubblico**: Conosci l'indirizzo IPv4 o IPv6 pubblico dove il proxy sarà accessibile da Internet +3. **Interfaccia di rete**: Identifica quale interfaccia di rete gestirà il traffico VoIP + +La procedura guidata rileva automaticamente se esiste già un proxy sul nodo di installazione di NethVoice e propone di installarlo se necessario. Successivamente, per configurare il Proxy NethVoice: + +1. **Configura il dominio del Proxy**: questo è il FQDN pubblico dove il proxy sarà raggiungibile. + Non inserire il FQDN di NethServer ma utilizza uno dedicato, come `proxy.nethserver.org`. + Questo nome sarà utilizzato dai client esterni per raggiungere i tuoi servizi VoIP, ma non sarà utilizzato direttamente dagli utenti finali. +2. **Abilita la richiesta del certificato Let's Encrypt** se necessario: verrà richiesto un certificato Let's Encrypt per il dominio del proxy. +3. **Imposta l'interfaccia di rete** che gestirà il traffico VoIP +4. **Configura l'indirizzo IP pubblico** se diverso dall'IP dell'interfaccia + +La configurazione sopra sarà il punto di ingresso per tutto il traffico VoIP esterno. + +Assicurati che: +- Il FQDN configurato risolva correttamente l'indirizzo IP pubblico +- Eventuali record DNS siano correttamente configurati per puntare al proxy + +Questi requisiti sono fondamentali per ottenere un certificato SSL/TLS valido per comunicazioni sicure. + +Consulta la [documentazione del Proxy NethVoice](../advanced/nethvoice_proxy.md) per maggiori informazioni. + +### Applicazione NethVoice {#applicazione-nethvoice} + +:::warning Configurazione DNS +Per configurare NethVoice, è necessario disporre di due virtual host dedicati: + +- Un **host base NethVoice** per l'interfaccia di amministrazione di NethVoice, ad esempio `nethvoice.nethserver.org` +- Un **host base CTI NethVoice** per l'applicazione web CTI di NethVoice, ad esempio `cti.nethserver.org` + +Prima di procedere con la configurazione, assicurati di aver creato i corrispondenti record DNS per questi FQDN nel tuo server DNS. + +Se prevedi di utilizzare un certificato Let's Encrypt come certificato predefinito, assicurati di avere i necessari record DNS pubblici. +::: + +Nell'ultimo passaggio della procedura guidata, ti verrà richiesto di fornire le seguenti informazioni: + +- **Host base NethVoice**: Inserisci un FQDN valido per accedere alla pagina di amministrazione dell'applicazione; qui gestirai le impostazioni di NethVoice, ad esempio `nethvoice.nethserver.org`. +- **Host base CTI NethVoice**: Inserisci un FQDN valido per l'applicazione web CTI di NethVoice, ad esempio `cti.nethserver.org`. +- **Richiedi certificato Let's Encrypt**: Se abilitato, verrà richiesto un certificato Let's Encrypt sia per l'**host base NethVoice** che per l'**host base CTI NethVoice**. +- **Fuso orario**: Seleziona il fuso orario appropriato per l'applicazione NethVoice; questo è importante per la registrazione accurata delle chiamate e la pianificazione. +- **Password amministratore per accedere all'interfaccia utente**: Imposta la password per la pagina di amministrazione di NethVoice. + +### Passaggi successivi {#passaggi-successivi} + +Al termine della procedura guidata di configurazione iniziale, NethVoice sarà accessibile sull'host base configurato, ad esempio: +``` +https://nethvoice.nethserver.org +``` + +Per accedere all'interfaccia di amministrazione di NethVoice, utilizza le seguenti credenziali: + +- Utente: `admin` +- Password: La password scelta nella procedura guidata di configurazione iniziale + +Dopo aver completato la configurazione di NethVoice nell'interfaccia di amministrazione, gli utenti possono accedere al CTI di NethVoice sull'host base configurato, ad esempio: +``` +https://cti.nethserver.org +``` + +## Configurazione del modulo {#configurazione-del-modulo} + +Le impostazioni del modulo NethVoice possono essere riviste e modificate accedendo al modulo NethVoice di NethServer 8. Per farlo: + +- Accedi alla pagina di amministrazione del cluster NethServer. +- Apri l'applicazione NethVoice dal **Cassetto delle applicazioni** o dalla **pagina Applicazioni**. +- Vai alla pagina di configurazione specifica che desideri modificare. + +Nella pagina **Impostazioni** puoi rivedere e modificare la maggior parte dei parametri di configurazione: + +- **Host base NethVoice**: virtual host per l'interfaccia di amministrazione di NethVoice. +- **Host base CTI NethVoice**: virtual host per l'applicazione web CTI di NethVoice. +- **Richiedi certificato Let's Encrypt**: se abilitato, verrà richiesto un certificato Let's Encrypt sia per l'**host base NethVoice** che per l'**host base CTI NethVoice**. +- **Provider di account**: dominio utenti utilizzato da NethVoice. +- **Fuso orario**: fuso orario per l'applicazione NethVoice, importante per la registrazione accurata delle chiamate e la pianificazione. +- **Prefisso dei report**: prefisso telefonico utilizzato nei report. +- **Nuova password amministratore per NethVoice**: definisci una nuova password per l'utente `admin`. + +Nella pagina **Integrazioni** puoi configurare la trascrizione di chiamate e messaggi vocali: +- **Chiave API Deepgram**: Inserisci la tua chiave API Deepgram per abilitare funzionalità avanzate di riconoscimento vocale e trascrizione. +- **Abilita trascrizione delle chiamate**: Abilita questa opzione per consentire agli utenti di trascrivere le chiamate in tempo reale utilizzando il servizio di conversione vocale in testo di Deepgram. Questa funzionalità comporta costi aggiuntivi in base all'utilizzo di Deepgram. +- **Trascrizione dei messaggi vocali**: Abilita la trascrizione dei messaggi vocali per convertirli in testo utilizzando Deepgram. Anche questa funzionalità comporta costi aggiuntivi in base all'utilizzo di Deepgram. + +:::info Trascrizione vocale +Per informazioni dettagliate su come gli utenti possono accedere e utilizzare le funzionalità di trascrizione vocale, consulta [Trascrizione vocale](../../user-manual/nethcti/other.md#voice-transcription) nel Manuale Utente. +::: + +Nella pagina **Rebranding** puoi personalizzare l'interfaccia utente di NethVoice con l'identità del marchio della tua azienda. Per abilitare questa funzionalità, devi contattare il team commerciale di Nethesis e avere un abbonamento Enterprise attivo. + +Nella pagina **Hotel** puoi configurare il modulo Hotel; è richiesto un abbonamento attivo per questa funzionalità. + +- **Stato**: Attiva il modulo Hotel per gestire funzionalità telefoniche specifiche per hotel. +- **Host server FIAS Hotel**: Inserisci l'indirizzo IP o il nome host del server FIAS dell'hotel. +- **Porta server FIAS Hotel**: Specifica il numero di porta per la connessione al server FIAS dell'hotel. + +Consulta la [documentazione del modulo Hotel di NethVoice](/docs/administrator-manual/nethhotel/index.md) per maggiori dettagli. \ No newline at end of file From 0d3de88bbd0ac41ede314f83c3869e25c0006a8d Mon Sep 17 00:00:00 2001 From: Andrea Leardini Date: Tue, 13 Jan 2026 15:51:37 +0100 Subject: [PATCH 05/22] Update docs/administrator-manual/install/index.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/administrator-manual/install/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/administrator-manual/install/index.md b/docs/administrator-manual/install/index.md index 38af2bb..b924e6a 100644 --- a/docs/administrator-manual/install/index.md +++ b/docs/administrator-manual/install/index.md @@ -49,7 +49,7 @@ Follow the [NethServer Installation guide](nethserver.md) to: - Access the web administration interface - Create your cluster -### Step 3: Install and configure NethVoice {#step-5-install-nethvoice} +### Step 3: Install and configure NethVoice {#step-3-install-nethvoice} Follow the [NethVoice Installation guide](nethvoice_install.md) to: - Install NethVoice From 3e1f24f115a81971e70376bd2a946ce2e1fa12c2 Mon Sep 17 00:00:00 2001 From: Andrea Leardini Date: Tue, 13 Jan 2026 15:51:54 +0100 Subject: [PATCH 06/22] Update i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/index.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- .../current/administrator-manual/install/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/index.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/index.md index 4ae8d6f..85ce8a7 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/index.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/index.md @@ -49,7 +49,7 @@ Segui la [guida all'installazione di NethServer](nethserver.md) per: - Accedere all'interfaccia di amministrazione web - Creare il tuo cluster -### Passaggio 3: Installare e configurare NethVoice {#step-5-install-nethvoice} +### Passaggio 3: Installare e configurare NethVoice {#step-3-install-nethvoice} Segui la [Guida all'installazione di NethVoice](nethvoice_install.md) per: - Installare NethVoice From b1fa84365aec6fcdb035b70f5979e98cd9702ffa Mon Sep 17 00:00:00 2001 From: Andrea Leardini Date: Tue, 13 Jan 2026 17:02:00 +0100 Subject: [PATCH 07/22] fix: minor improvements --- .../install/nethvoice_install.md | 6 +++--- docs/tutorial/index.md | 14 +++----------- 2 files changed, 6 insertions(+), 14 deletions(-) diff --git a/docs/administrator-manual/install/nethvoice_install.md b/docs/administrator-manual/install/nethvoice_install.md index fe654a4..6a56e23 100644 --- a/docs/administrator-manual/install/nethvoice_install.md +++ b/docs/administrator-manual/install/nethvoice_install.md @@ -20,7 +20,7 @@ If you want a ready-to-use NethVoice installation, please consider: 3. **Click "Install"** next to NethVoice. 4. **Wait for installation** to complete (this may take a few minutes). -## First setup wizard {#setup-wizard} +## First-time setup wizard {#setup-wizard} Open the NethVoice application from the **Applications** page or from the **Application Drawer** in NethServer 8. A first-time configuration wizard will appear and guide you through: - Configuring an account provider for NethVoice @@ -127,7 +127,7 @@ In the last step of the setup wizard, you will be prompted to provide the follow ### Next steps {#next-steps} -At the end of the first-time configuration wizard, NethVoice will be accessible on the base host configured, e.g.: +At the end of the first-time setup wizard, NethVoice will be accessible on the base host configured, e.g.: ``` https://nethvoice.nethserver.org ``` @@ -135,7 +135,7 @@ https://nethvoice.nethserver.org To access the NethVoice administration interface, use the following credentials: - User: `admin` -- Password: The password you have chosen in the first-time configuration wizard +- Password: The password you have chosen in the first-time setup wizard After completing NethVoice configuration in the administration interface, users can access NethVoice CTI on the base host configured, e.g.: ``` diff --git a/docs/tutorial/index.md b/docs/tutorial/index.md index 774954b..189ae0a 100644 --- a/docs/tutorial/index.md +++ b/docs/tutorial/index.md @@ -21,25 +21,17 @@ Begin by installing NethServer 8 on your server. - **Password:** `Nethesis,1234` - Create a cluster and ensure your server has a static IP address and a valid FQDN. -## 2. Install and Configure NethVoice Proxy {#2-install-and-configure-nethvoice-proxy} - -The NethVoice Proxy is required to enable secure remote access to NethVoice services. -- Install the NethVoice Proxy module from the Software Center. -- Assign a valid FQDN (e.g., `proxy.yourdomain.org`) and ensure the DNS record is configured. -- Configure the network interface and public IP as needed. -- Only one NethVoice Proxy can be installed per node. -- For detailed steps, refer to the [NethVoice Proxy documentation](https://docs.nethvoice.com/docs/administrator-manual/install/nethvoice_install#step-1-install-nethvoice-proxy). - -## 3. Install NethVoice Module {#3-install-nethvoice-module} +## 2. Install NethVoice Module {#3-install-nethvoice-module} Once the proxy is configured, you can install the NethVoice module: - Open the **Software Center** from the web interface. - Search for the NethVoice application and click **Install**. - For more information, see the [Software Center documentation](https://docs.nethserver.org/projects/ns8/en/latest/software_center.html). -## 4. Configure NethVoice {#4-configure-nethvoice} +## 3. Configure NethVoice {#4-configure-nethvoice} After installation, configure your NethVoice instance: +- Follow the [first-time setup wizard](https://docs.nethvoice.com/docs/administrator-manual/install/nethvoice_install#setup-wizard) - Follow the [NethVoice configuration guide](https://docs.nethvoice.com/docs/administrator-manual/install/nethvoice_install#module-configuration) for detailed setup instructions. - Complete the initial configuration, add users, and set up your telephony environment as needed. From 1201652697448506da3e676e5c41ca59ede5bb81 Mon Sep 17 00:00:00 2001 From: Translation Sync Bot Date: Tue, 13 Jan 2026 16:05:44 +0000 Subject: [PATCH 08/22] docs: auto-sync translations for PR #33 --- .../current/tutorial/index.md | 28 +++++++------------ 1 file changed, 10 insertions(+), 18 deletions(-) diff --git a/i18n/it/docusaurus-plugin-content-docs/current/tutorial/index.md b/i18n/it/docusaurus-plugin-content-docs/current/tutorial/index.md index a01e91f..e702fcd 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/tutorial/index.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/tutorial/index.md @@ -19,27 +19,19 @@ Inizia installando NethServer 8 sul tuo server. - **Password:** `Nethesis,1234` - Crea un cluster e assicurati che il server abbia un IP statico e un FQDN valido. -## 2. Installare e configurare il Proxy NethVoice {#2-install-and-configure-nethvoice-proxy} +## 2. Installa il modulo NethVoice {#2-installa-il-modulo-nethvoice} -Il Proxy NethVoice è necessario per abilitare l'accesso remoto sicuro ai servizi NethVoice. -- Installa il modulo Proxy NethVoice dal Software Center. -- Assegna un FQDN valido (es. `proxy.tuodominio.org`) e verifica che il record DNS sia configurato. -- Configura l'interfaccia di rete e l'IP pubblico secondo necessità. -- Può essere installato un solo Proxy NethVoice per nodo. -- Per i passaggi dettagliati, consulta la [documentazione del Proxy NethVoice](https://docs.nethvoice.com/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md#step-1-install-nethvoice-proxy). +Una volta configurato il proxy, è possibile installare il modulo NethVoice: +- Aprire il **Software Center** dall'interfaccia web. +- Cercare l'applicazione NethVoice e fare clic su **Install**. +- Per maggiori informazioni, consultare la [documentazione del Software Center](https://docs.nethserver.org/projects/ns8/en/latest/software_center.html). -## 3. Installare il modulo NethVoice {#3-install-nethvoice-module} +## 3. Configura NethVoice {#3-configura-nethvoice} -Una volta configurato il proxy, puoi installare il modulo NethVoice: -- Apri il **Software Center** dall'interfaccia web. -- Cerca l'applicazione NethVoice e clicca su **Installa**. -- Per maggiori informazioni, consulta la [documentazione del Software Center](https://docs.nethserver.org/projects/ns8/it/latest/software_center.html). - -## 4. Configurare NethVoice {#4-configure-nethvoice} - -Dopo l'installazione, configura la tua istanza NethVoice: -- Segui la [guida alla configurazione di NethVoice](https://docs.nethvoice.com/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md#module-configuration) per istruzioni dettagliate. -- Completa la configurazione iniziale, aggiungi utenti e configura l'ambiente telefonico secondo le tue esigenze. +Dopo l'installazione, configurare l'istanza NethVoice: +- Seguire il [wizard di configurazione iniziale](https://docs.nethvoice.com/docs/administrator-manual/install/nethvoice_install#setup-wizard) +- Seguire la [guida alla configurazione di NethVoice](https://docs.nethvoice.com/docs/administrator-manual/install/nethvoice_install#module-configuration) per istruzioni dettagliate sulla configurazione. +- Completare la configurazione iniziale, aggiungere utenti e configurare l'ambiente di telefonia secondo necessità. --- From 10a72369cc930c0745b00bda7f01539deec5aef0 Mon Sep 17 00:00:00 2001 From: Andrea Leardini Date: Tue, 13 Jan 2026 17:06:38 +0100 Subject: [PATCH 09/22] remove sentence from italian file --- .../current/administrator-manual/install/nethserver.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md index 121a8d0..29fa990 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md @@ -249,5 +249,3 @@ Se hai bisogno di riconfigurare le impostazioni di rete: - **Rocky Linux**: Utilizza `nmtui` o modifica i file di NetworkManager - **Debian**: Utilizza `netplan` o `/etc/network/interfaces` - **CentOS Stream/AlmaLinux**: Utilizza `nmcli` o `nmtui` - -## Registrare NethServer {#registrare-nethserver} \ No newline at end of file From 7f52292658dd0d059be429610bb9b9607712adaf Mon Sep 17 00:00:00 2001 From: Translation Sync Bot Date: Tue, 13 Jan 2026 16:07:29 +0000 Subject: [PATCH 10/22] docs: auto-sync translations for PR #33 --- .../install/nethserver.md | 59 ++----------------- 1 file changed, 4 insertions(+), 55 deletions(-) diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md index 29fa990..4650147 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md @@ -7,7 +7,6 @@ sidebar_position: 2 NethVoice gira sopra **NethServer 8 (NS8)**, una piattaforma infrastruttura Linux unificata open-source. Questa pagina ti guida attraverso l'installazione di NethServer 8, che è un prerequisito per l'installazione di NethVoice. - :::tip Se desideri un'installazione pronta all'uso di NethServer, prendi in considerazione il nostro servizio **[NethServer 8 SaaS](saas.md#nethserver-8-saas)**, che fornisce un'istanza NethServer completamente gestita nel cloud. ::: @@ -141,60 +140,10 @@ Ulteriori informazioni disponibili nella [documentazione ufficiale di NethServer Dopo la configurazione del cluster, puoi: -1. **Installa dominio utente**: [Configura LDAP o Active Directory](#user-domains) -2. **Installa NethVoice**: Procedi con l'[installazione di NethVoice](nethvoice_install) tramite il Software Center -3. **Registra NethServer**: Attiva il tuo [abbonamento Enterprise](#register-nethserver) - -## Domini utente {#user-domains} - -I domini utente archiviano utenti e gruppi in un database LDAP. NethVoice richiede almeno un dominio utente per gestire interni, utenti e autenticazione. - -### Panoramica - -NethServer 8 supporta due tipi di provider di account LDAP: - -| Provider | Tipo | Ideale per | Funzionalità | -|----------|------|----------|----------| -| **OpenLDAP (RFC2307)** | Interno | Client Unix/Linux, setup semplice | Lightweight, configurazione facile, distribuzioni più piccole, più istanze per nodo | -| **Active Directory (Samba)** | Interno | Client Windows, condivisione file SMB | Domain controller, compatibilità Windows, complessità più elevata, un'istanza per nodo | -| **LDAP esterno** | Esterno | Infrastruttura LDAP esistente | Connessione a server esistenti (Active Directory, OpenLDAP, ecc.) | - -:::info Requisito di NethVoice -NethVoice richiede almeno un dominio utente configurato. Scegli **OpenLDAP (RFC2307)** per distribuzioni più semplici o **Active Directory** se hai bisogno del supporto del client Windows. -::: - -### Setup veloce: OpenLDAP (consigliato per NethVoice) - -OpenLDAP è l'opzione più semplice per distribuzioni solo NethVoice: - -1. **Accedi all'interfaccia web di NethServer 8** dopo il completamento dell'installazione -2. **Naviga alla sezione Domini e utenti** -3. **Fai clic su "Crea dominio"** e scegli **"Interno"** -4. **Seleziona "OpenLDAP"** come provider -5. **Immetti il nome del dominio** (ad es. `nethvoice.local`) - questo è un nome logico, non correlato a DNS -6. **Imposta il nome utente e la password dell'amministratore di OpenLDAP** -7. **Fai clic su "Installa provider"** - -Il dominio sarà pronto immediatamente. Puoi ora: -- Creare utenti e gruppi per gli interni di NethVoice -- Gestire l'autenticazione dell'utente -- Configurare NethVoice per utilizzare questo dominio - -:::tip -Mantieni le credenziali dell'amministratore di OpenLDAP in un luogo sicuro. Le avrai bisogno per attività amministrative. -::: - -Per scenari avanzati (LDAP esterno, Active Directory, setup DNS, policy di password, gestione utenti), vedi la [documentazione ufficiale dei domini utente di NethServer 8](https://docs.nethserver.org/projects/ns8/en/latest/user_domains.htm). - -Argomenti chiave nella documentazione ufficiale: -- **Setup di Active Directory**: Configurazione completa del domain controller -- **Connessione LDAP esterna**: Binding a server LDAP esistenti -- **Policy di password**: Impostazioni di età, forza e scadenza -- **Portale di gestione utenti**: Modifiche della password self-service -- **Repliche del provider LDAP**: Tolleranza ai guasti e ridondanza -- **Impostazioni di binding LDAP**: Connessione di applicazione esterna a un server LDAP in esecuzione localmente +1. **Installa NethVoice**: Procedi con l'[installazione di NethVoice](nethvoice_install) tramite il Software Center +2. **Registra NethServer**: Attiva il tuo [abbonamento Enterprise](#registrare-nethserver) -## Registra NethServer {#register-nethserver} +## Registrare NethServer {#registrare-nethserver} NethServer deve avere una subscription Enterprise per sbloccare tutte le funzionalità di NethVoice. Consulta la [sezione subscription](../index.md#subscription) per ulteriori informazioni. @@ -248,4 +197,4 @@ Se hai bisogno di riconfigurare le impostazioni di rete: - Aggiorna la configurazione di rete utilizzando: - **Rocky Linux**: Utilizza `nmtui` o modifica i file di NetworkManager - **Debian**: Utilizza `netplan` o `/etc/network/interfaces` - - **CentOS Stream/AlmaLinux**: Utilizza `nmcli` o `nmtui` + - **CentOS Stream/AlmaLinux**: Utilizza `nmcli` o `nmtui` \ No newline at end of file From 8bc3920c2b6bf4995e152ec2698a29b743bbcb13 Mon Sep 17 00:00:00 2001 From: Andrea Leardini Date: Tue, 13 Jan 2026 17:11:27 +0100 Subject: [PATCH 11/22] fix anchor link --- .../current/administrator-manual/install/nethserver.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md index 4650147..d022ebd 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md @@ -143,7 +143,7 @@ Dopo la configurazione del cluster, puoi: 1. **Installa NethVoice**: Procedi con l'[installazione di NethVoice](nethvoice_install) tramite il Software Center 2. **Registra NethServer**: Attiva il tuo [abbonamento Enterprise](#registrare-nethserver) -## Registrare NethServer {#registrare-nethserver} +## Registrare NethServer {#register-nethserver} NethServer deve avere una subscription Enterprise per sbloccare tutte le funzionalità di NethVoice. Consulta la [sezione subscription](../index.md#subscription) per ulteriori informazioni. From 745276459031b7294b4fc3681f2eeebc5a577822 Mon Sep 17 00:00:00 2001 From: Andrea Leardini Date: Wed, 14 Jan 2026 10:53:54 +0100 Subject: [PATCH 12/22] fix italian translation of nethvoice_proxy --- .../advanced/nethvoice_proxy.md | 8 ++-- .../advanced/nethvoice_proxy.md | 44 +++++++++---------- 2 files changed, 26 insertions(+), 26 deletions(-) diff --git a/docs/administrator-manual/advanced/nethvoice_proxy.md b/docs/administrator-manual/advanced/nethvoice_proxy.md index 8706481..c72f451 100644 --- a/docs/administrator-manual/advanced/nethvoice_proxy.md +++ b/docs/administrator-manual/advanced/nethvoice_proxy.md @@ -81,11 +81,11 @@ You can install only one NethVoice Proxy per node from the Software Center. NethVoice Proxy must be installed **before** deploying any NethVoice instances. -1. **Open NethServer Management Interface** on your node +1. **Open NethServer Management Interface** 2. **Navigate to Software Center** 3. **Search for "NethVoice Proxy"** 4. **Click "Install"** and wait for installation to complete -5. **Proceed to Configuration** (see section below) +5. **Proceed to configuration** (see section below) ## Configuration {#configuration} @@ -94,7 +94,7 @@ NethVoice Proxy must be installed **before** deploying any NethVoice instances. Before configuring NethVoice Proxy, ensure: 1. **DNS Records Created**: Create a DNS A/AAAA record for the proxy domain (e.g., `proxy.nethserver.org`) pointing to your public IP address -2. **Public IP Address**: Know the public IPv4 or IPv6 address where the proxy will be accessible from the internet +2. **Public IP Address**: Identify the public IPv4 or IPv6 address where the proxy will be accessible from the internet 3. **Network Interface**: Identify which network interface will handle VoIP traffic ### Configuration Steps {#configuration-steps} @@ -109,7 +109,7 @@ NethVoice Proxy is usually configured during the setup wizard of a NethVoice mod - Enable Let's Encrypt to automatically manage SSL certificates for the proxy domain - This requires the DNS record to be publicly resolvable 4. **Select Network Interface**: Choose the network interface that will handle VoIP traffic from the dropdown menu - - Typically the interface connected to your WAN/Internet + - This is typically the interface connected to your WAN/Internet 5. **Configure Public IP Address**: - Enter the public IPv4 or IPv6 address if different from the interface IP - This is necessary if your node is behind a router/NAT diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/advanced/nethvoice_proxy.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/advanced/nethvoice_proxy.md index 3540bc2..4ee7fe5 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/advanced/nethvoice_proxy.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/advanced/nethvoice_proxy.md @@ -5,7 +5,7 @@ sidebar_position: 5 # NethVoice Proxy -## Panoramica +## Panoramica {#overview} NethVoice Proxy è un componente critico che gestisce tutto il traffico VoIP esterno per le istanze di NethVoice. Agisce come gateway per le connessioni SIP e RTP basate su Internet, abilitando l'accesso esterno sicuro al tuo sistema telefonico. @@ -20,7 +20,7 @@ NethVoice Proxy fornisce: **Importante**: NethVoice Proxy è richiesto per ogni distribuzione di NethVoice, anche con una singola istanza. Gestisce l'accesso a Internet esterno e deve essere installato e configurato prima di distribuire eventuali istanze di NethVoice. ::: -## Architettura +## Architettura {#architecture} Il modulo NethVoice Proxy è costruito su due componenti open-source principali: @@ -31,9 +31,9 @@ Il modulo NethVoice Proxy è costruito su due componenti open-source principali: Questi componenti lavorano insieme per gestire tutte le connessioni SIP e RTP in entrata e in uscita tra le tue istanze di NethVoice e le reti VoIP esterne (Internet, trunk, uffici remoti, utenti mobili). -## Ruolo nelle distribuzioni di NethVoice +## Ruolo nelle distribuzioni di NethVoice {#role-in-nethvoice-deployments} -### Distribuzione con singola istanza +### Distribuzione con singola istanza {#single-instance-deployment} Anche con una singola installazione di NethVoice, NethVoice Proxy è essenziale: - Agisce come interfaccia esterna per il traffico VoIP basato su Internet @@ -41,7 +41,7 @@ Anche con una singola installazione di NethVoice, NethVoice Proxy è essenziale: - Gestisce l'attraversamento NAT per le connessioni mobili e remote - Fornisce un singolo dominio affinché gli utenti esterni raggiungano il tuo PBX -### Distribuzione con più istanze +### Distribuzione con più istanze {#multi-instance-deployment} Con più istanze di NethVoice sullo stesso nodo, NethVoice Proxy fornisce: - **Punto di ingresso esterno unico**: I chiamanti esterni utilizzano un FQDN (il dominio proxy) @@ -67,37 +67,37 @@ In questo scenario: - Ogni istanza opera in modo indipendente mentre condivide l'accesso esterno ::: -## Installazione +## Installazione {#installation} ### Installazione consigliata: {#installation-steps} -NethVoice Proxy viene installato come parte della procedura guidata di configurazione del modulo NethVoice. Consultare [Installazione di NethVoice](../install/nethvoice_install.md) per la sequenza completa di installazione. +Il NethVoice Proxy viene installato come parte della procedura guidata di configurazione del modulo NethVoice. Consulta [Installazione di NethVoice](../install/nethvoice_install.md) per la sequenza completa di installazione. ### Installazione manuale (non consigliata): :::note -È possibile installare un solo NethVoice Proxy per nodo dal Software Center. +È possibile installare un solo NethVoice Proxy per ogni nodo dal Software Center. ::: -NethVoice Proxy deve essere installato **prima** di distribuire qualsiasi istanza di NethVoice. +NethVoice Proxy deve essere installato **prima** di configurare qualsiasi istanza di NethVoice. -1. **Aprire l'interfaccia di gestione di NethServer** sul proprio nodo -2. **Navigare al Software Center** -3. **Selezionare "NethVoice Proxy"** dall'elenco dei pacchetti disponibili +1. **Aprire l'interfaccia di gestione di NethServer** +2. **Navigare al Software Center** +3. **Cercare "NethVoice Proxy"** 4. **Fare clic su "Installa"** e attendere il completamento dell'installazione 5. **Procedere alla configurazione** (vedere la sezione seguente) -## Configurazione +## Configurazione {#configuration} -### Prerequisiti +### Prerequisiti {#prerequisites} Prima di configurare NethVoice Proxy, assicurati che: 1. **Record DNS creati**: Crea un record DNS A/AAAA per il dominio proxy (ad es. `proxy.nethserver.org`) che punta al tuo indirizzo IP pubblico -2. **Indirizzo IP pubblico**: Conosci l'indirizzo IPv4 o IPv6 pubblico dove il proxy sarà accessibile da Internet +2. **Indirizzo IP pubblico**: Identifica l'indirizzo IPv4 o IPv6 pubblico dove il proxy sarà accessibile da Internet 3. **Interfaccia di rete**: Identifica quale interfaccia di rete gestirà il traffico VoIP -### Passaggi di configurazione {#configuration-steps} +### Passi di configurazione {#configuration-steps} NethVoice Proxy viene solitamente configurato durante la procedura guidata di configurazione di un modulo NethVoice (consultare [Installazione di NethVoice](../install/nethvoice_install.md) per la sequenza completa di installazione). Per rivedere o modificare la configurazione del proxy: @@ -109,13 +109,13 @@ NethVoice Proxy viene solitamente configurato durante la procedura guidata di co - Abilitare Let's Encrypt per gestire automaticamente i certificati SSL per il dominio del proxy - Questo richiede che il record DNS sia risolvibile pubblicamente 4. **Selezionare l'interfaccia di rete**: Scegliere l'interfaccia di rete che gestirà il traffico VoIP dal menu a tendina - - Tipicamente l'interfaccia connessa alla rete WAN/Internet + - Tipicamente questa è l'interfaccia connessa alla rete WAN/Internet 5. **Configurare l'indirizzo IP pubblico**: - Inserire l'indirizzo IPv4 o IPv6 pubblico se diverso dall'IP dell'interfaccia - Questo è necessario se il nodo si trova dietro un router/NAT - Lasciare vuoto se l'interfaccia ha un IP pubblico diretto -### Esempio di configurazione +### Esempio di configurazione {#configuration-example} **Scenario**: Nodo singolo con interfaccia di rete privata, IP pubblico dietro NAT @@ -128,9 +128,9 @@ NethVoice Proxy viene solitamente configurato durante la procedura guidata di co **Risultato**: I dispositivi esterni si connettono a `proxy.example.com` (203.0.113.45), il traffico si instrada internamente a 192.168.1.10 -### Casi speciali +### Casi speciali {#special-cases} -#### Solo rete locale (senza accesso a Internet) +#### Solo rete locale (senza accesso a Internet) {#local-network-only-no-internet-access} Se il proxy è accessibile solo all'interno di una rete locale e non da Internet: @@ -143,7 +143,7 @@ Let's Encrypt: Disabilitato Utilizza l'indirizzo IP privato che i dispositivi sulla tua rete locale usano per raggiungere il proxy. -#### Più IP esterni +#### Più IP esterni {#multiple-external-ips} Se il tuo nodo ha più indirizzi IP pubblici, configura il proxy con l'IP pubblico specifico che desideri per il traffico VoIP: @@ -165,4 +165,4 @@ Utenti/Trunk esterni ``` Il proxy agisce come gateway tra il traffico VoIP esterno e le istanze interne di NethVoice. -::: \ No newline at end of file +::: From de2fefd624356800cc3ee04adccc83062d47ec35 Mon Sep 17 00:00:00 2001 From: Andrea Leardini Date: Wed, 14 Jan 2026 11:22:22 +0100 Subject: [PATCH 13/22] fix install/index.md --- docs/administrator-manual/install/index.md | 6 ++-- .../configuration/index.md | 4 +-- .../administrator-manual/install/index.md | 34 +++++++++---------- 3 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/administrator-manual/install/index.md b/docs/administrator-manual/install/index.md index b924e6a..803f505 100644 --- a/docs/administrator-manual/install/index.md +++ b/docs/administrator-manual/install/index.md @@ -53,7 +53,7 @@ Follow the [NethServer Installation guide](nethserver.md) to: Follow the [NethVoice Installation guide](nethvoice_install.md) to: - Install NethVoice -- Complete the setup configuration wizard +- Complete the setup configuration wizard: - Configure an account provider - Install and configure a NethVoice Proxy - Set up virtual hosts, certificates and administration password @@ -61,7 +61,7 @@ Follow the [NethVoice Installation guide](nethvoice_install.md) to: ## Quick Reference {#quick-reference} -### System Requirements (Minimum) {#system-requirements-minimum} +### Minimum System Requirements {#system-requirements-minimum} | Component | Requirement | |-----------|-------------| @@ -130,7 +130,7 @@ Complete guide covering: - Configuration (domain, interface, public IP) - SSL certificate setup - Verification and testing -- Must be installed BEFORE NethVoice +- Must be installed before NethVoice ## Installation Checklist {#installation-checklist} diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/configuration/index.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/configuration/index.md index 595f423..d345bcd 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/configuration/index.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/configuration/index.md @@ -7,7 +7,7 @@ sidebar_position: 4 La sezione Configurazione contiene documentazione per la gestione e il monitoraggio del sistema NethVoice dopo la configurazione iniziale. -## Pagine chiave +## Pagine chiave {#key-pages} - **[Procedura guidata](./configuration/wizard)** - Accedi alla procedura guidata di configurazione per la configurazione e la personalizzazione del sistema - **[Dashboard](./configuration/dashboard)** - Monitora lo stato del sistema, gli utenti e le informazioni di presenza @@ -16,4 +16,4 @@ La sezione Configurazione contiene documentazione per la gestione e il monitorag :::info Per iniziare Per la configurazione iniziale di NethVoice, inizia con la [procedura guidata di configurazione](./configuration/wizard). -::: \ No newline at end of file +::: diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/index.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/index.md index 85ce8a7..bfbc1da 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/index.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/index.md @@ -11,10 +11,10 @@ Questa sezione copre il processo di installazione completo per NethVoice, dall'i L'installazione di NethVoice è un processo in due fasi: -1. **[Installazione di NethServer 8](nethserver.md)** - Installare la piattaforma base NethServer 8 -2. **[Installazione di NethVoice](nethvoice_install.md)** - Installare e configurare l'applicazione NethVoice +1. **[Installazione di NethServer 8](nethserver.md)** - Installa la piattaforma base NethServer 8 +2. **[Installazione di NethVoice](nethvoice_install.md)** - Installa e configurare l'applicazione NethVoice -## Cos'è NethServer 8? +## Cos'è NethServer 8? {#what-is-nethserver-8} NethServer 8 (NS8) è la piattaforma infrastruttura Linux sottostante su cui gira NethVoice. Fornisce: @@ -28,9 +28,9 @@ NethServer 8 (NS8) è la piattaforma infrastruttura Linux sottostante su cui gir NethVoice richiede che NethServer 8 sia installato per primo. Assicurati di completare l'installazione di NethServer 8 prima di procedere con NethVoice. ::: -## Percorso di installazione +## Percorso di installazione {#installation-path} -### Passaggio 1: Prerequisiti +### Passaggio 1: Prerequisiti {#step-1-prerequisites} Prima di iniziare, assicurati di avere: @@ -41,7 +41,7 @@ Prima di iniziare, assicurati di avere: - Connessione Internet funzionante - Nome di dominio completamente qualificato (FQDN) registrato e risolto -### Passaggio 2: Installa NethServer 8 +### Passaggio 2: Installa NethServer 8 {#step-2-install-nethserver-8} Segui la [guida all'installazione di NethServer](nethserver.md) per: - Installare i componenti core di NethServer 8 @@ -59,9 +59,9 @@ Segui la [Guida all'installazione di NethVoice](nethvoice_install.md) per: - Configurare virtual host, certificati e password di amministrazione - Accedere all'interfaccia di amministrazione di NethVoice e CTI -## Riferimento veloce +## Quick Reference {#quick-reference} -### Requisiti di sistema (Minimo) +### Requisiti minimi di sistema {#system-requirements-minimum} | Componente | Requisito | |-----------|-------------| @@ -72,7 +72,7 @@ Segui la [Guida all'installazione di NethVoice](nethvoice_install.md) per: | OS | **Rocky Linux 9** (subscription supportato) - AlmaLinux 9, CentOS Stream 9, Debian 12 (community supportato) | | Browser | Firefox, Chrome o Chromium (versione attuale) | -### Metodi di installazione +### Metodi di installazione {#installation-methods} **NethServer 8** può essere installato tramite: - Script di installazione standard (consigliato) @@ -96,7 +96,7 @@ Cambia le credenziali predefinite immediatamente dopo il primo accesso per motiv ## Guide dettagliate -### [Installazione di NethServer 8](nethserver.md) +### [Installazione di NethServer 8](nethserver.md) {#nethserver-8-installation} Guida completa che copre: - Requisiti di sistema e consigli hardware @@ -121,7 +121,7 @@ Guida completa che copre: - Accesso amministratore - Configurazione iniziale -### [Installazione di NethVoice Proxy](../advanced/nethvoice_proxy.md) +### [Installazione di NethVoice Proxy](../advanced/nethvoice_proxy.md) {#nethvoice-proxy-installation} Guida completa che copre: - Panoramica del proxy e architettura @@ -130,9 +130,9 @@ Guida completa che copre: - Configurazione (dominio, interfaccia, IP pubblico) - Configurazione del certificato SSL - Verifica e test -- Deve essere installato PRIMA di NethVoice +- Deve essere installato prima di NethVoice -## Elenco di controllo dell'installazione +## Checklist dell'installazione {#installation-checklist} Prima di iniziare, assicurati che: @@ -145,7 +145,7 @@ Prima di iniziare, assicurati che: - [ ] La connessione Internet è stabile - [ ] Hai accesso amministrativo al server -## Note importanti +## Note importanti {#important-notes} :::info **Solo piattaforme supportate**: Installa NethServer 8 solo su distribuzioni supportate. Sistemi desktop e server che eseguono altri servizi non sono supportati. @@ -174,9 +174,9 @@ Dopo l'installazione iniziale, NethServer 8 supporta: Vedi la [documentazione di NethServer 8](https://docs.nethserver.org/projects/ns8/) per i dettagli del clustering. -## Risoluzione dei problemi +## Risoluzione dei problemi {#troubleshooting} -### Problemi comuni +### Problemi comuni {#common-issues} **Non è possibile accedere all'interfaccia web** - Verifica la configurazione dell'indirizzo IP statico @@ -198,7 +198,7 @@ Vedi la [documentazione di NethServer 8](https://docs.nethserver.org/projects/ns Per ulteriore aiuto, consulta le guide dettagliate o la documentazione di NethServer 8. -## Passaggi successivi +## Passaggi successivi {#next-steps} Dopo l'installazione completata con successo: From 931c966e9b4c8371cb866a1933fe21f2dfda25b1 Mon Sep 17 00:00:00 2001 From: Andrea Leardini Date: Wed, 14 Jan 2026 11:27:24 +0100 Subject: [PATCH 14/22] fix install/nethserver.md --- .../administrator-manual/install/nethserver.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md index d022ebd..55a22db 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md @@ -94,15 +94,15 @@ Per accedere all'interfaccia web di NethServer 8, utilizza una versione aggiorna - Chrome - Chromium -## Metodi di installazione +## Metodi di installazione {#installation-methods} NethServer 8 può essere installato utilizzando due metodi: -### Metodo 1: Procedura standard +### Metodo 1: Procedura standard {#method-1-standard-procedure} Per la maggior parte delle installazioni, utilizza la procedura di installazione standard. -#### Passaggi di installazione +#### Passaggi di installazione {#installation-steps} 1. **Installa curl** (se non già disponibile): ```bash @@ -116,13 +116,13 @@ curl https://raw.githubusercontent.com/NethServer/ns8-core/ns8-stable/core/insta 3. **Attendi il completamento**: Lo script installerà tutti i componenti core di NethServer 8. -### Metodo 2: Immagine di macchina virtuale pre-costruita +### Metodo 2: Immagine di macchina virtuale pre-costruita {#method-2-pre-built-virtual-machine-image} Un'immagine Rocky Linux 9 pre-costruita è disponibile per la distribuzione rapida su piattaforme virtuali. Vedi la documentazione ufficiale di NethServer per più dettagli: [Immagini pre-costruite di NethServer 8](https://docs.nethserver.org/projects/ns8/en/latest/install.html#pre-built-image). -## Passaggi post-installazione +## Passaggi post-installazione {#post-installation-steps} Dopo il completamento dell'installazione: @@ -140,8 +140,8 @@ Ulteriori informazioni disponibili nella [documentazione ufficiale di NethServer Dopo la configurazione del cluster, puoi: -1. **Installa NethVoice**: Procedi con l'[installazione di NethVoice](nethvoice_install) tramite il Software Center -2. **Registra NethServer**: Attiva il tuo [abbonamento Enterprise](#registrare-nethserver) +1. **Installare NethVoice**: Procedi con l'[installazione di NethVoice](nethvoice_install) tramite il Software Center +2. **Registrare NethServer**: Attiva il tuo [abbonamento Enterprise](#registrare-nethserver) ## Registrare NethServer {#register-nethserver} @@ -197,4 +197,4 @@ Se hai bisogno di riconfigurare le impostazioni di rete: - Aggiorna la configurazione di rete utilizzando: - **Rocky Linux**: Utilizza `nmtui` o modifica i file di NetworkManager - **Debian**: Utilizza `netplan` o `/etc/network/interfaces` - - **CentOS Stream/AlmaLinux**: Utilizza `nmcli` o `nmtui` \ No newline at end of file + - **CentOS Stream/AlmaLinux**: Utilizza `nmcli` o `nmtui` From a797189985dd2ebdb16bc97071ba38737ff444ba Mon Sep 17 00:00:00 2001 From: Andrea Leardini Date: Wed, 14 Jan 2026 11:47:09 +0100 Subject: [PATCH 15/22] fix install/nethvoice_install.md --- .../install/nethvoice_install.md | 4 +- .../install/nethvoice_install.md | 191 +++--------------- 2 files changed, 32 insertions(+), 163 deletions(-) diff --git a/docs/administrator-manual/install/nethvoice_install.md b/docs/administrator-manual/install/nethvoice_install.md index 6a56e23..f630cb6 100644 --- a/docs/administrator-manual/install/nethvoice_install.md +++ b/docs/administrator-manual/install/nethvoice_install.md @@ -81,7 +81,7 @@ NethVoice Proxy is a standard NethServer 8 application: its settings can be revi Before configuring NethVoice Proxy, ensure: 1. **DNS Records Created**: Create a DNS A/AAAA record for the proxy domain (e.g., `proxy.nethserver.org`) pointing to your public IP address -2. **Public IP Address**: Know the public IPv4 or IPv6 address where the proxy will be accessible from the internet +2. **Public IP Address**: Identify the public IPv4 or IPv6 address where the proxy will be accessible from the internet 3. **Network Interface**: Identify which network interface will handle VoIP traffic The setup wizard detects automatically if there already is a proxy on the installation node of NethVoice and proposes to install it if needed. Then, to configure the NethVoice Proxy: @@ -162,7 +162,7 @@ On the **Settings** page you can review and change most of the configuration par On the **Integrations** page you can configure call and voicemail transcription: - **Deepgram API Key**: Enter your Deepgram API key to enable advanced speech recognition features and voice transcription. -- **Enable call transcription**: Enable this option to allow users to transcribe calls in real-time using Deepgram's speech-to-text service. This feature incurs additional costs based on your Deepgram usage. +- **Call transcription**: Enable this option to allow users to transcribe calls in real-time using Deepgram's speech-to-text service. This feature incurs additional costs based on your Deepgram usage. - **Voicemail transcription**: Enable voicemail transcription to convert voicemail messages to text using Deepgram. This feature also incurs additional costs based on your Deepgram usage. :::info Voice Transcription diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md index a5fb532..2910fa4 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md @@ -13,153 +13,21 @@ Se desideri un'installazione di NethVoice pronta all'uso, prendi in considerazio - un **[VoiceBox Appliance](voicebox.md)**, l'appliance hardware con NethServer e NethVoice preinstallati ::: -## Panoramica - -NethVoice è installato in due passaggi: - -1. **NethVoice Proxy** (richiesto per primo) -2. **Modulo/i NethVoice** - -NethVoice Proxy è un componente obbligatorio che deve essere installato e configurato **prima** di distribuire istanze di NethVoice. Ciò si applica anche se stai installando solo una singola istanza di NethVoice. - -:::warning Ordine di installazione -**NethVoice Proxy deve essere installato PER PRIMO, prima di NethVoice.** - -Il proxy gestisce tutto l'accesso a Internet esterno e gestisce l'instradamento del traffico SIP/RTP. È richiesto per: -- Accesso esterno da Internet -- Delega del traffico a più installazioni di NethVoice sullo stesso nodo -- Gestione dei collegamenti SIP e RTP per tutte le istanze di NethVoice -- Terminazione SSL/TLS per il traffico VoIP esposto a Internet - -Anche con una singola installazione di NethVoice, il proxy è essenziale per una corretta gestione del traffico di rete. -::: - -## Passaggi di installazione - -### Passaggio 1: Installa NethVoice Proxy +## Installazione modulo {#module-installation} 1. **Accedi al Software Center** nel tuo sistema NethServer 8. -2. **Cerca "NethVoice Proxy"** nella barra di ricerca del Software Center. -3. **Fai clic su "Installa"** accanto a NethVoice Proxy. -4. **Attendi il completamento dell'installazione** (potrebbe richiedere alcuni minuti). -5. **Procedi alla configurazione del proxy** prima di passare al passaggio successivo (vedi [Configurazione di NethVoice Proxy](#step-2-configure-nethvoice-proxy)). - -:::tip Importante -Assicurati che NethVoice Proxy sia completamente installato e configurato con FQDN appropriate e record DNS prima di procedere all'installazione delle istanze di NethVoice. -::: - -### Passaggio 2: Configura NethVoice Proxy {#step-2-configure-nethvoice-proxy} - -Prima di installare NethVoice, devi configurare NethVoice Proxy: - -1. **Configura il dominio proxy** questo è l'FQDN pubblico dove il proxy sarà raggiungibile. - Non inserire l'FQDN di NethServer ma utilizzarne uno dedicato, come `proxy.nethserver.org`. - Questo nome verrà utilizzato dai client esterni per raggiungere i tuoi servizi VoIP, ma - non verrà utilizzato direttamente dagli utenti finali. -2. **Imposta l'interfaccia di rete** che gestirà il traffico VoIP -3. **Configura l'indirizzo IP pubblico** se diverso dall'IP dell'interfaccia - -La configurazione precedente sarà il punto di ingresso per tutto il traffico VoIP esterno. - -Assicurati che: -- l'FQDN configurato si risolva correttamente all'indirizzo IP pubblico -- eventuali record DNS siano configurati correttamente per puntare al proxy - -Questi requisiti sono critici per ottenere un certificato SSL/TLS valido per le comunicazioni sicure. - -Vedi [Documentazione di NethVoice Proxy](../advanced/nethvoice_proxy.md) per ulteriori informazioni. - -### Passaggio 3: Installa NethVoice - -Una volta che NethVoice Proxy è in esecuzione, puoi installare le istanze di NethVoice: - -1. **Torna al Software Center** nel tuo sistema NethServer 8. 2. **Cerca "NethVoice"** nella barra di ricerca del Software Center. 3. **Fai clic su "Installa"** accanto a NethVoice. -4. **Attendi il completamento dell'installazione**. -5. **Procedi con la configurazione del modulo** come descritto nella sezione successiva. -6. **Accedi all'istanza di NethVoice** e segui la procedura guidata di configurazione iniziale per completare la configurazione. - -:::info Più istanze -Puoi installare più istanze di NethVoice sullo stesso nodo. Ognuna utilizzerà il NethVoice Proxy condiviso per l'accesso esterno e l'instradamento del traffico. Ogni istanza richiede una configurazione separata e FQDN dedicati. -::: - -## Configurazione del modulo {#module-configuration} - -:::warning Prerequisiti richiesti -Prima di procedere con la configurazione di qualsiasi istanza di NethVoice, assicurati che: - -1. **NethVoice Proxy sia installato** - Vedi [Installazione di NethVoice Proxy](../advanced/nethvoice_proxy.md) -2. **NethVoice Proxy sia configurato** - Il dominio proxy (FQDN) deve essere impostato e i record DNS creati -3. **NethVoice Proxy sia in esecuzione** - Verifica lo stato del proxy nell'interfaccia di gestione del nodo -4. **Il dominio utente sia creato** - Vedi [Domini utente nell'installazione di NethServer](./nethserver.md#user-domains) (richiesto per gli utenti e gli interni di NethVoice) - -Il modulo NethVoice richiede almeno un dominio utente per gestire utenti, interni e autenticazione. Se non hai ancora creato un dominio utente, segui la [guida alla configurazione dei domini utente](./nethserver.md#user-domains) prima di configurare NethVoice. -::: - -Per configurare NethVoice, hai bisogno di due host virtuali dedicati: - -- uno per la pagina di amministrazione di NethVoice, ad es. `nethvoice.nethserver.org` -- uno per l'applicazione web NethVoice CTI, ad es. `cti.nethserver.org` - -Prima di procedere con la configurazione, assicurati di aver creato i record DNS corrispondenti per questi FQDN nel tuo server DNS. - -Se prevedi di utilizzare un certificato Let's Encrypt come certificato predefinito, assicurati di avere i necessari record DNS pubblici. - -Durante la procedura guidata di configurazione del modulo, ti verrà chiesto di fornire le seguenti informazioni: - -- **Host base di NethVoice**: Inserisci un FQDN valido per accedere alla pagina di amministrazione dell'applicazione, qui è dove gestirai le impostazioni di NethVoice, ad es. `nethvoice.nethserver.org`. -- **Host base di NethVoice CTI**: Inserisci un FQDN valido per accedere all'applicazione web NethVoice CTI, ad es. `cti.nethserver.org`. -- **Dominio utente**: Scegli uno dei [domini utente](./nethserver.md#user-domains) già configurati. -- **Fuso orario**: Seleziona il fuso orario appropriato per la tua istanza di NethVoice, questo è importante per la registrazione e la pianificazione accurate delle chiamate. -- **Richiedi certificato Let's Encrypt**: Se abilitato, verrà richiesto un certificato Let's Encrypt per ognuno dei due host. -- **Prefisso report**: Inserisci il prefisso telefonico internazionale da considerare locale nel sistema di reporting. -- **Ripristina la password dell'amministratore di NethVoice per accedere all'interfaccia utente**: Inserisci una password valida per l'utente amministratore di NethVoice (facoltativo, la password predefinita è *Nethesis,1234*). - -Opzioni di configurazione avanzata: - -- **Chiave API di Deepgram**: Inserisci la tua chiave API di Deepgram per abilitare funzionalità di riconoscimento vocale avanzate e trascrizione vocale. - - **Abilita trascrizione delle chiamate**: Abilita questa opzione per permettere agli utenti di trascrivere le chiamate in tempo reale utilizzando il servizio speech-to-text di Deepgram. Questa funzione comporta costi aggiuntivi in base al tuo utilizzo di Deepgram. - - **Trascrizione della segreteria telefonica**: Abilita la trascrizione della segreteria telefonica per convertire i messaggi della segreteria telefonica in testo utilizzando Deepgram. Questa funzione comporta anche costi aggiuntivi in base al tuo utilizzo di Deepgram. - -:::info Trascrizione vocale -Per informazioni dettagliate su come gli utenti possono accedere e utilizzare le funzionalità di trascrizione vocale, vedi [Trascrizione Vocale](../../user-manual/nethcti/other.md#voice-transcription) nel Manuale Utente. -::: - -Le seguenti opzioni sono disponibili solo con un abbonamento Enterprise attivo: - -- **Abilita modulo hotel**: Attiva il modulo Hotel per la gestione delle funzionalità telefoniche specifiche dell'hotel. - Vedi [Documentazione del modulo NethVoice Hotel](../nethhotel/index.md) per ulteriori dettagli. -- **Host del server Hotel FIAS**: Inserisci l'indirizzo IP o il nome host del server Hotel FIAS. -- **Porta del server Hotel FIAS**: Specifica il numero di porta per la connessione al server Hotel FIAS. - -## Passaggi successivi - -Dopo aver salvato i parametri di configurazione, NethVoice sarà accessibile al suo host base, ad es: -``` -https://nethvoice.nethserver.org -``` - -Per accedere all'interfaccia di amministrazione di NethVoice, utilizza le seguenti credenziali: - -- Utente: `admin` -- Password: `Nethesis,1234`, la password predefinita se l'opzione *Ripristina la password dell'amministratore di NethVoice per accedere all'interfaccia utente* non è stata utilizzata durante la configurazione - -## Installazione del modulo {#installazione-del-modulo} - -1. **Accedi al Software Center** sul tuo sistema NethServer 8. -2. **Cerca "NethVoice"** nella barra di ricerca del Software Center. -3. **Fai clic su "Installa"** accanto a NethVoice. -4. **Attendi il completamento dell'installazione** (potrebbero essere necessari alcuni minuti). +4. **Attendi il completamento dell'installazione** (potrebbe richiedere alcuni minuti). -## Procedura guidata di configurazione iniziale {#procedura-guidata-di-configurazione} +## Procedura guidata di configurazione iniziale {#setup-wizard} -Apri l'applicazione NethVoice dalla **pagina Applicazioni** o dal **Cassetto delle applicazioni** in NethServer 8. Apparirà una procedura guidata di configurazione iniziale che ti guiderà attraverso: +Apri l'applicazione NethVoice dalla pagina **Applicazioni** o dal **Application Drawer** in NethServer 8. Apparirà una procedura guidata di configurazione iniziale che ti guiderà attraverso: - Configurazione di un provider di account per NethVoice -- Installazione e configurazione del Proxy NethVoice +- Installazione e configurazione del NethVoice Proxy - Configurazione dell'applicazione NethVoice -### Provider di account {#provider-di-account} +### Provider di account Il primo passaggio della procedura guidata ti aiuta a configurare il dominio utenti utilizzato da NethVoice. @@ -176,7 +44,7 @@ NethServer 8 supporta due tipi di provider di account LDAP: NethVoice richiede almeno un dominio utenti configurato. Scegli **OpenLDAP (RFC2307)** per distribuzioni più semplici o **Active Directory** se hai bisogno di supporto per client Windows. ::: -#### Configurazione rapida: OpenLDAP (Consigliato per NethVoice) {#configurazione-rapida-openldap-consigliato-per-nethvoice} +#### Configurazione rapida: OpenLDAP (Consigliato per NethVoice) {#quick-setup-openldap-recommended-for-nethvoice} La procedura guidata consente di installare facilmente un provider di account OpenLDAP. Per configurarlo, devi: @@ -193,28 +61,29 @@ Argomenti chiave nella documentazione ufficiale: - **Repliche del provider LDAP**: Tolleranza ai guasti e ridondanza - **Impostazioni di binding LDAP**: Collegamento di applicazioni esterne a un server LDAP locale -### Proxy NethVoice {#proxy-nethvoice} +### NethVoice Proxy -Il passaggio successivo della procedura guidata iniziale installa e configura il Proxy NethVoice. +Il passaggio successivo della procedura guidata iniziale installa e configura il NethVoice Proxy. -Il Proxy NethVoice è un componente che deve essere installato e configurato prima di distribuire le istanze dell'applicazione NethVoice. Anche con una sola installazione di NethVoice, il proxy è essenziale per una corretta gestione del traffico di rete. +Il NethVoice Proxy è un componente che deve essere installato e configurato prima di configurare le istanze applicative di NethVoice. Anche con una sola installazione di NethVoice, il proxy è essenziale per una corretta gestione del traffico di rete. Il proxy gestisce tutto l'accesso esterno a Internet e il routing del traffico SIP/RTP. È necessario per: - Accesso esterno da Internet +- Delegazione del traffico verso più installazioni NethVoice sullo stesso nodo - Gestione delle connessioni SIP e RTP per tutte le istanze di NethVoice - Terminazione SSL/TLS per il traffico VoIP esposto a Internet -Il Proxy NethVoice è un'applicazione standard di NethServer 8: le sue impostazioni possono essere riviste e modificate accedendo dal **Cassetto delle applicazioni** o dalla **pagina Applicazioni**. +Il NethVoice Proxy è un'applicazione standard di NethServer 8: le sue impostazioni possono essere riviste e modificate accedendo dal **Application drawer** o dalla pagina **Applicazioni**. #### Prerequisiti {#prerequisiti} -Prima di configurare il Proxy NethVoice, assicurati che: +Prima di configurare il NethVoice Proxy: 1. **Record DNS creati**: Crea un record DNS A/AAAA per il dominio del proxy (es. `proxy.nethserver.org`) che punti al tuo indirizzo IP pubblico -2. **Indirizzo IP pubblico**: Conosci l'indirizzo IPv4 o IPv6 pubblico dove il proxy sarà accessibile da Internet +2. **Indirizzo IP pubblico**: Identifica l'indirizzo IPv4 o IPv6 pubblico dove il proxy sarà accessibile da Internet 3. **Interfaccia di rete**: Identifica quale interfaccia di rete gestirà il traffico VoIP -La procedura guidata rileva automaticamente se esiste già un proxy sul nodo di installazione di NethVoice e propone di installarlo se necessario. Successivamente, per configurare il Proxy NethVoice: +La procedura guidata rileva automaticamente se esiste già un proxy sul nodo di installazione di NethVoice e propone di installarlo se necessario. Successivamente, per configurare il NethVoice Proxy: 1. **Configura il dominio del Proxy**: questo è il FQDN pubblico dove il proxy sarà raggiungibile. Non inserire il FQDN di NethServer ma utilizza uno dedicato, come `proxy.nethserver.org`. @@ -231,15 +100,15 @@ Assicurati che: Questi requisiti sono fondamentali per ottenere un certificato SSL/TLS valido per comunicazioni sicure. -Consulta la [documentazione del Proxy NethVoice](../advanced/nethvoice_proxy.md) per maggiori informazioni. +Consulta la [documentazione del NethVoice Proxy](../advanced/nethvoice_proxy.md) per maggiori informazioni. -### Applicazione NethVoice {#applicazione-nethvoice} +### Applicazione NethVoice :::warning Configurazione DNS Per configurare NethVoice, è necessario disporre di due virtual host dedicati: -- Un **host base NethVoice** per l'interfaccia di amministrazione di NethVoice, ad esempio `nethvoice.nethserver.org` -- Un **host base CTI NethVoice** per l'applicazione web CTI di NethVoice, ad esempio `cti.nethserver.org` +- Un **Host base NethVoice** per l'interfaccia di amministrazione di NethVoice, ad esempio `nethvoice.nethserver.org` +- Un **Host base NethVoice CTI** per l'applicazione web NethVoice CTI, ad esempio `cti.nethserver.org` Prima di procedere con la configurazione, assicurati di aver creato i corrispondenti record DNS per questi FQDN nel tuo server DNS. @@ -249,12 +118,12 @@ Se prevedi di utilizzare un certificato Let's Encrypt come certificato predefini Nell'ultimo passaggio della procedura guidata, ti verrà richiesto di fornire le seguenti informazioni: - **Host base NethVoice**: Inserisci un FQDN valido per accedere alla pagina di amministrazione dell'applicazione; qui gestirai le impostazioni di NethVoice, ad esempio `nethvoice.nethserver.org`. -- **Host base CTI NethVoice**: Inserisci un FQDN valido per l'applicazione web CTI di NethVoice, ad esempio `cti.nethserver.org`. -- **Richiedi certificato Let's Encrypt**: Se abilitato, verrà richiesto un certificato Let's Encrypt sia per l'**host base NethVoice** che per l'**host base CTI NethVoice**. +- **Host base NethVoice CTI**: Inserisci un FQDN valido per l'applicazione web NethVoice CTI, ad esempio `cti.nethserver.org`. +- **Richiedi certificato Let's Encrypt**: Se abilitato, verrà richiesto un certificato Let's Encrypt sia per l'**host base NethVoice** che per l'**Host base NethVoice CTI**. - **Fuso orario**: Seleziona il fuso orario appropriato per l'applicazione NethVoice; questo è importante per la registrazione accurata delle chiamate e la pianificazione. - **Password amministratore per accedere all'interfaccia utente**: Imposta la password per la pagina di amministrazione di NethVoice. -### Passaggi successivi {#passaggi-successivi} +### Passaggi successivi {#next-steps} Al termine della procedura guidata di configurazione iniziale, NethVoice sarà accessibile sull'host base configurato, ad esempio: ``` @@ -266,32 +135,32 @@ Per accedere all'interfaccia di amministrazione di NethVoice, utilizza le seguen - Utente: `admin` - Password: La password scelta nella procedura guidata di configurazione iniziale -Dopo aver completato la configurazione di NethVoice nell'interfaccia di amministrazione, gli utenti possono accedere al CTI di NethVoice sull'host base configurato, ad esempio: +Dopo aver completato la configurazione di NethVoice nell'interfaccia di amministrazione, gli utenti possono accedere al NethVoice CTI sull'host base configurato, ad esempio: ``` https://cti.nethserver.org ``` -## Configurazione del modulo {#configurazione-del-modulo} +## Configurazione del modulo {#module-configuration} Le impostazioni del modulo NethVoice possono essere riviste e modificate accedendo al modulo NethVoice di NethServer 8. Per farlo: - Accedi alla pagina di amministrazione del cluster NethServer. -- Apri l'applicazione NethVoice dal **Cassetto delle applicazioni** o dalla **pagina Applicazioni**. +- Apri l'applicazione NethVoice dall'**Application drawer** o dalla pagina **Applicazioni**. - Vai alla pagina di configurazione specifica che desideri modificare. Nella pagina **Impostazioni** puoi rivedere e modificare la maggior parte dei parametri di configurazione: - **Host base NethVoice**: virtual host per l'interfaccia di amministrazione di NethVoice. -- **Host base CTI NethVoice**: virtual host per l'applicazione web CTI di NethVoice. -- **Richiedi certificato Let's Encrypt**: se abilitato, verrà richiesto un certificato Let's Encrypt sia per l'**host base NethVoice** che per l'**host base CTI NethVoice**. +- **Host base NethVoice CTI**: virtual host per l'applicazione web NethVoice CTI. +- **Richiedi certificato Let's Encrypt**: se abilitato, verrà richiesto un certificato Let's Encrypt sia per l'**Host base NethVoice** che per l'**Host base NethVoice CTI**. - **Provider di account**: dominio utenti utilizzato da NethVoice. - **Fuso orario**: fuso orario per l'applicazione NethVoice, importante per la registrazione accurata delle chiamate e la pianificazione. - **Prefisso dei report**: prefisso telefonico utilizzato nei report. - **Nuova password amministratore per NethVoice**: definisci una nuova password per l'utente `admin`. Nella pagina **Integrazioni** puoi configurare la trascrizione di chiamate e messaggi vocali: -- **Chiave API Deepgram**: Inserisci la tua chiave API Deepgram per abilitare funzionalità avanzate di riconoscimento vocale e trascrizione. -- **Abilita trascrizione delle chiamate**: Abilita questa opzione per consentire agli utenti di trascrivere le chiamate in tempo reale utilizzando il servizio di conversione vocale in testo di Deepgram. Questa funzionalità comporta costi aggiuntivi in base all'utilizzo di Deepgram. +- **API Key Deepgram**: Inserisci la tua chiave API Deepgram per abilitare funzionalità avanzate di riconoscimento vocale e trascrizione. +- **Trascrizione delle chiamate**: Abilita questa opzione per consentire agli utenti di trascrivere le chiamate in tempo reale utilizzando il servizio di conversione vocale in testo di Deepgram. Questa funzionalità comporta costi aggiuntivi in base all'utilizzo di Deepgram. - **Trascrizione dei messaggi vocali**: Abilita la trascrizione dei messaggi vocali per convertirli in testo utilizzando Deepgram. Anche questa funzionalità comporta costi aggiuntivi in base all'utilizzo di Deepgram. :::info Trascrizione vocale @@ -306,4 +175,4 @@ Nella pagina **Hotel** puoi configurare il modulo Hotel; è richiesto un abbonam - **Host server FIAS Hotel**: Inserisci l'indirizzo IP o il nome host del server FIAS dell'hotel. - **Porta server FIAS Hotel**: Specifica il numero di porta per la connessione al server FIAS dell'hotel. -Consulta la [documentazione del modulo Hotel di NethVoice](/docs/administrator-manual/nethhotel/index.md) per maggiori dettagli. \ No newline at end of file +Consulta la [documentazione del modulo Hotel di NethVoice](/docs/administrator-manual/nethhotel/index.md) per maggiori dettagli. From 69ed68698eff8cb75f7ab68bfebf701b07422eaf Mon Sep 17 00:00:00 2001 From: Andrea Leardini Date: Wed, 14 Jan 2026 11:51:13 +0100 Subject: [PATCH 16/22] fix administrator-manual/index.md --- .../current/administrator-manual/index.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/index.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/index.md index eb65572..bc7b5c0 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/index.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/index.md @@ -92,19 +92,19 @@ Prima di distribuire NethVoice, assicuratevi di avere: - ✅ **Requisiti di Rete**: IP statico, DNS configurato, connettività internet - ✅ **NethServer 8**: Completamente installato e configurato (vedere [Guida all'Installazione](./install/index.md)) - ✅ **Dominio Utente**: Creato per utenti e autenticazione (vedere [Domini Utente nell'Installazione NethServer](./install/nethserver.md#user-domains)) -- ✅ **Proxy NethVoice**: Installato e configurato con FQDN appropriato e record DNS (richiesto per qualsiasi distribuzione di NethVoice) +- ✅ **NethVoice Proxy**: Installato e configurato con FQDN appropriato e record DNS (richiesto per qualsiasi distribuzione di NethVoice) -### Passaggi di Distribuzione +### Passaggi di configurazione {#deployment-steps} 1. **[Verificare i Requisiti di Sistema](./install/nethserver.md#system-requirements)** - Assicuratevi che la vostra infrastruttura soddisfi i requisiti 2. **[Installare NethServer 8](./install/nethserver.md)** - Distribuire la piattaforma infrastruttura base -3. **[Installa e configura NethVoice](./install/nethvoice_install.md)** - Installa il Proxy NethVoice e i moduli NethVoice. +3. **[Installa e configura NethVoice](./install/nethvoice_install.md)** - Installa i moduli NethVoice Proxy NethVoice. 4. **Configurare il Vostro Sistema**: - [Provisioning Telefoni](./provisioning/index.md) - Distribuire e configurare dispositivi telefonici - [Gestire Interni](../user-manual/nethcti/index.md) - Creare interni e assegnare agli utenti 5. **[Configurazione Avanzata](./advanced/index.md)** - Configurare trunk, gateway, instradamento e funzionalità avanzate -## Sezioni Documentazione Principale +## Sezioni Documentazione Principale {#key-documentation-sections} | Sezione | Scopo | Argomenti | |---------|-------|----------| @@ -118,15 +118,15 @@ Potete installare più istanze di NethVoice sullo stesso nodo NethServer 8 dal S ::: :::warning Prerequisiti -Il modulo NethVoice richiede che il **proxy NethVoice** sia già installato, configurato e in esecuzione sul sistema. +Il modulo NethVoice richiede che il **NethVoice Proxy** sia già installato, configurato e in esecuzione sul sistema. -**Perché?** Il Proxy NethVoice: +**Perché?** Il NethVoice Proxy: - Gestisce tutto il traffico VoIP esterno da internet - Gestisce instradamento del traffico SIP/RTP e delegazione - Abilita l'accesso esterno anche con una singola istanza di NethVoice - Instrada il traffico tra più installazioni di NethVoice sullo stesso nodo -Se non avete ancora configurato il proxy, fare riferimento alla [documentazione Proxy NethVoice](./advanced/nethvoice_proxy.md) prima di installare NethVoice. +Se non avete ancora configurato il proxy, fare riferimento alla [documentazione NethVoice Proxy](./advanced/nethvoice_proxy.md) prima di installare NethVoice. ::: ## Subscription {#subscription} @@ -189,4 +189,4 @@ Nethesis offre una suite completa di soluzioni ICT modulari e indipendenti che r - **[NethSpot](https://www.nethesis.it/soluzioni/nethspot)** — Gestione hotspot WiFi pubblici. Migliora l'esperienza guest con proximity marketing, login social, gestione centralizzata del WiFi e controllo della banda. -Tutte le soluzioni sono indipendenti dalla modalità di distribuzione: installabili su appliance certificate, macchine virtuali, cloud privati o hardware compatibile. Per maggiori informazioni visitate [www.nethesis.it](https://www.nethesis.it) o contattate [marketing@nethesis.it](mailto:marketing@nethesis.it). \ No newline at end of file +Tutte le soluzioni sono indipendenti dalla modalità di distribuzione: installabili su appliance certificate, macchine virtuali, cloud privati o hardware compatibile. Per maggiori informazioni visitate [www.nethesis.it](https://www.nethesis.it) o contattate [marketing@nethesis.it](mailto:marketing@nethesis.it). From 16e4b7f967cab4d42cdafa4a08bdf3a67a4e3667 Mon Sep 17 00:00:00 2001 From: Andrea Leardini Date: Wed, 14 Jan 2026 11:54:40 +0100 Subject: [PATCH 17/22] fix tutorial/nethvoice_install.md --- docs/tutorial/index.md | 6 +++--- .../current/tutorial/index.md | 6 +++--- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/tutorial/index.md b/docs/tutorial/index.md index 189ae0a..8d99bab 100644 --- a/docs/tutorial/index.md +++ b/docs/tutorial/index.md @@ -12,7 +12,7 @@ Designed to run on [NethServer](https://www.nethserver.org/), NethVoice supports This guide will walk you through the basic steps to set up NethVoice on your system. -## 1. Install NethServer 8 {#1-install-nethserver-8} +## 1. Install NethServer 8 {#install-nethserver-8} Begin by installing NethServer 8 on your server. - Download and follow the installation instructions from the [official guide](https://docs.nethserver.org/projects/ns8/en/latest/install.html). @@ -21,14 +21,14 @@ Begin by installing NethServer 8 on your server. - **Password:** `Nethesis,1234` - Create a cluster and ensure your server has a static IP address and a valid FQDN. -## 2. Install NethVoice Module {#3-install-nethvoice-module} +## 2. Install NethVoice Module {#install-nethvoice-module} Once the proxy is configured, you can install the NethVoice module: - Open the **Software Center** from the web interface. - Search for the NethVoice application and click **Install**. - For more information, see the [Software Center documentation](https://docs.nethserver.org/projects/ns8/en/latest/software_center.html). -## 3. Configure NethVoice {#4-configure-nethvoice} +## 3. Configure NethVoice {#configure-nethvoice} After installation, configure your NethVoice instance: - Follow the [first-time setup wizard](https://docs.nethvoice.com/docs/administrator-manual/install/nethvoice_install#setup-wizard) diff --git a/i18n/it/docusaurus-plugin-content-docs/current/tutorial/index.md b/i18n/it/docusaurus-plugin-content-docs/current/tutorial/index.md index e702fcd..62e61e1 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/tutorial/index.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/tutorial/index.md @@ -10,7 +10,7 @@ Progettata per funzionare su [NethServer](https://www.nethserver.org/), NethVoic Questa guida ti accompagnerà nei passaggi fondamentali per configurare NethVoice sul tuo sistema. -## 1. Installare NethServer 8 {#1-install-nethserver-8} +## 1. Installare NethServer 8 {#install-nethserver-8} Inizia installando NethServer 8 sul tuo server. - Scarica e segui le istruzioni di installazione dalla [guida ufficiale](https://docs.nethserver.org/projects/ns8/it/latest/install.html). @@ -19,14 +19,14 @@ Inizia installando NethServer 8 sul tuo server. - **Password:** `Nethesis,1234` - Crea un cluster e assicurati che il server abbia un IP statico e un FQDN valido. -## 2. Installa il modulo NethVoice {#2-installa-il-modulo-nethvoice} +## 2. Installa il modulo NethVoice {#install-nethvoice-module} Una volta configurato il proxy, è possibile installare il modulo NethVoice: - Aprire il **Software Center** dall'interfaccia web. - Cercare l'applicazione NethVoice e fare clic su **Install**. - Per maggiori informazioni, consultare la [documentazione del Software Center](https://docs.nethserver.org/projects/ns8/en/latest/software_center.html). -## 3. Configura NethVoice {#3-configura-nethvoice} +## 3. Configura NethVoice {#configure-nethvoice} Dopo l'installazione, configurare l'istanza NethVoice: - Seguire il [wizard di configurazione iniziale](https://docs.nethvoice.com/docs/administrator-manual/install/nethvoice_install#setup-wizard) From b96a26cb6e8cb3ef64aa4472cba2b246365677de Mon Sep 17 00:00:00 2001 From: Andrea Leardini Date: Wed, 14 Jan 2026 12:21:16 +0100 Subject: [PATCH 18/22] fix anchor links --- docs/administrator-manual/index.md | 2 -- docs/administrator-manual/install/nethvoice_install.md | 4 ++-- docs/administrator-manual/install/voicebox.md | 2 +- .../current/administrator-manual/index.md | 2 -- .../current/administrator-manual/install/nethserver.md | 2 +- .../current/administrator-manual/install/nethvoice_install.md | 4 ++-- .../current/administrator-manual/install/voicebox.md | 2 +- .../docusaurus-plugin-content-docs/current/tutorial/index.md | 2 ++ 8 files changed, 9 insertions(+), 11 deletions(-) diff --git a/docs/administrator-manual/index.md b/docs/administrator-manual/index.md index 46dfe3a..cfedf0b 100644 --- a/docs/administrator-manual/index.md +++ b/docs/administrator-manual/index.md @@ -91,8 +91,6 @@ Before deploying NethVoice, ensure you have: - ✅ **System Resources**: Minimum 2 vCPU, 2GB RAM, 40GB storage per instance - ✅ **Network Requirements**: Static IP, DNS configured, internet connectivity - ✅ **NethServer 8**: Fully installed and configured (see [Installation Guide](./install/index.md)) -- ✅ **User Domain**: Created for users and authentication (see [User Domains in NethServer Installation](./install/nethserver.md#user-domains)) -- ✅ **NethVoice Proxy**: Installed and configured with proper FQDN and DNS records (required for any NethVoice deployment) ### Deployment Steps {#deployment-steps} diff --git a/docs/administrator-manual/install/nethvoice_install.md b/docs/administrator-manual/install/nethvoice_install.md index f630cb6..89c0d45 100644 --- a/docs/administrator-manual/install/nethvoice_install.md +++ b/docs/administrator-manual/install/nethvoice_install.md @@ -27,7 +27,7 @@ Open the NethVoice application from the **Applications** page or from the **Appl - Installing and configuring the NethVoice Proxy - Configuring the NethVoice application -### Account Provider +### Account Provider {#user-domains} The first step of the setup wizard helps you configure the user domain used by NethVoice. @@ -177,4 +177,4 @@ On the **Hotel** page you can configure the Hotel module; an active subscription - **Hotel FIAS server host**: Enter the IP address or hostname of the Hotel FIAS server. - **Hotel FIAS server port**: Specify the port number for the Hotel FIAS server connection. -See [NethVoice Hotel Module Documentation](/docs/administrator-manual/nethhotel/index.md) for more details. +See [NethVoice Hotel Module Documentation](/docs/administrator-manual/nethhotel/) for more details. diff --git a/docs/administrator-manual/install/voicebox.md b/docs/administrator-manual/install/voicebox.md index 6cdc042..1b2171f 100644 --- a/docs/administrator-manual/install/voicebox.md +++ b/docs/administrator-manual/install/voicebox.md @@ -119,7 +119,7 @@ Register the NethServer 8 instance in the service center: - Complete the registration process :::note User Database -The appliance comes pre-configured with an internal LDAP user database. To use an existing user database instead, see [User Domains Configuration in NethServer](nethserver.md#user-domains). +The appliance comes pre-configured with an internal LDAP user database. To use an existing user database instead, see [User Domains Configuration](nethvoice_install.md#user-domains). ::: ### 3. Enable Let's Encrypt Certificates diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/index.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/index.md index bc7b5c0..1499d28 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/index.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/index.md @@ -91,8 +91,6 @@ Prima di distribuire NethVoice, assicuratevi di avere: - ✅ **Risorse di Sistema**: Minimo 2 vCPU, 2GB RAM, 40GB storage per istanza - ✅ **Requisiti di Rete**: IP statico, DNS configurato, connettività internet - ✅ **NethServer 8**: Completamente installato e configurato (vedere [Guida all'Installazione](./install/index.md)) -- ✅ **Dominio Utente**: Creato per utenti e autenticazione (vedere [Domini Utente nell'Installazione NethServer](./install/nethserver.md#user-domains)) -- ✅ **NethVoice Proxy**: Installato e configurato con FQDN appropriato e record DNS (richiesto per qualsiasi distribuzione di NethVoice) ### Passaggi di configurazione {#deployment-steps} diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md index 55a22db..ddcea59 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethserver.md @@ -141,7 +141,7 @@ Ulteriori informazioni disponibili nella [documentazione ufficiale di NethServer Dopo la configurazione del cluster, puoi: 1. **Installare NethVoice**: Procedi con l'[installazione di NethVoice](nethvoice_install) tramite il Software Center -2. **Registrare NethServer**: Attiva il tuo [abbonamento Enterprise](#registrare-nethserver) +2. **Registrare NethServer**: Attiva il tuo [abbonamento Enterprise](#register-nethserver) ## Registrare NethServer {#register-nethserver} diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md index 2910fa4..4425ee1 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md @@ -27,7 +27,7 @@ Apri l'applicazione NethVoice dalla pagina **Applicazioni** o dal **Application - Installazione e configurazione del NethVoice Proxy - Configurazione dell'applicazione NethVoice -### Provider di account +### Provider di account {#user-domains} Il primo passaggio della procedura guidata ti aiuta a configurare il dominio utenti utilizzato da NethVoice. @@ -175,4 +175,4 @@ Nella pagina **Hotel** puoi configurare il modulo Hotel; è richiesto un abbonam - **Host server FIAS Hotel**: Inserisci l'indirizzo IP o il nome host del server FIAS dell'hotel. - **Porta server FIAS Hotel**: Specifica il numero di porta per la connessione al server FIAS dell'hotel. -Consulta la [documentazione del modulo Hotel di NethVoice](/docs/administrator-manual/nethhotel/index.md) per maggiori dettagli. +Consulta la [documentazione del modulo Hotel di NethVoice](/docs/administrator-manual/nethhotel/) per maggiori dettagli. diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/voicebox.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/voicebox.md index b8025ab..7bc59e9 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/voicebox.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/voicebox.md @@ -119,7 +119,7 @@ Registra l'istanza di NethServer 8 nel centro servizi: - Completa il processo di registrazione :::note Database utenti -L'appliance è pre-configurata con un database utenti LDAP interno. Per usare un database utenti esistente, vedi [Configurazione dei domini utente in NethServer](nethserver.md#user-domains). +L'appliance è pre-configurata con un database utenti LDAP interno. Per usare un database utenti esistente, vedi [Configurazione dei domini utente in NethServer](nethvoice_install.md#user-domains). ::: ### 3. Abilita i certificati Let's Encrypt diff --git a/i18n/it/docusaurus-plugin-content-docs/current/tutorial/index.md b/i18n/it/docusaurus-plugin-content-docs/current/tutorial/index.md index 62e61e1..ac356c3 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/tutorial/index.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/tutorial/index.md @@ -1,5 +1,7 @@ +--- title: Getting started sidebar_position: 1 +--- # Guida introduttiva a NethVoice From 9e3e901eb73fc948cd408945777badfc47342332 Mon Sep 17 00:00:00 2001 From: Andrea Leardini Date: Wed, 14 Jan 2026 12:30:42 +0100 Subject: [PATCH 19/22] fix link ns8 docs --- docs/administrator-manual/install/nethvoice_install.md | 2 +- .../current/administrator-manual/install/nethvoice_install.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/administrator-manual/install/nethvoice_install.md b/docs/administrator-manual/install/nethvoice_install.md index 89c0d45..6067ff7 100644 --- a/docs/administrator-manual/install/nethvoice_install.md +++ b/docs/administrator-manual/install/nethvoice_install.md @@ -52,7 +52,7 @@ The setup wizard lets you quickly and easily install an OpenLDAP account provide - **Enter domain name** (e.g., `nethvoice.local`) - this is a logical name, not DNS-related - **Set OpenLDAP admin username and password** -For advanced scenarios (external LDAP, Active Directory, DNS setup, password policies, user management), see the [official NethServer 8 User Domains documentation](https://docs.nethserver.org/projects/ns8/en/latest/user_domains.htm). +For advanced scenarios (external LDAP, Active Directory, DNS setup, password policies, user management), see the [official NethServer 8 User Domains documentation](https://docs.nethserver.org/projects/ns8/en/latest/user_domains.html). Key topics in the official docs: - **Active Directory Setup**: Complete domain controller configuration diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md index 4425ee1..89a3805 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md @@ -51,7 +51,7 @@ La procedura guidata consente di installare facilmente un provider di account Op - **Inserire il nome del dominio** (es. `nethvoice.local`) - questo è un nome logico, non correlato al DNS - **Impostare nome utente e password dell'amministratore di OpenLDAP** -Per scenari avanzati (LDAP esterno, Active Directory, configurazione DNS, politiche di password, gestione utenti), consulta la [documentazione ufficiale sui domini utenti di NethServer 8](https://docs.nethserver.org/projects/ns8/en/latest/user_domains.htm). +Per scenari avanzati (LDAP esterno, Active Directory, configurazione DNS, politiche di password, gestione utenti), consulta la [documentazione ufficiale sui domini utenti di NethServer 8](https://docs.nethserver.org/projects/ns8/en/latest/user_domains.html). Argomenti chiave nella documentazione ufficiale: - **Configurazione di Active Directory**: Configurazione completa del controller di dominio From 04129c63f8b95b616ec8a22d4cf316bba5aa3766 Mon Sep 17 00:00:00 2001 From: Andrea Leardini Date: Wed, 14 Jan 2026 16:53:24 +0100 Subject: [PATCH 20/22] review by gsanchietti Co-authored-by: Giacomo Sanchietti --- docs/administrator-manual/advanced/nethvoice_proxy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/administrator-manual/advanced/nethvoice_proxy.md b/docs/administrator-manual/advanced/nethvoice_proxy.md index c72f451..58edaf4 100644 --- a/docs/administrator-manual/advanced/nethvoice_proxy.md +++ b/docs/administrator-manual/advanced/nethvoice_proxy.md @@ -69,7 +69,7 @@ In this scenario: ## Installation {#installation} -### Recommended Installation: {#installation-steps} +### Recommended Installation {#installation-steps} NethVoice proxy is installed as part of the NethVoice module setup wizard. See [NethVoice Installation](../install/nethvoice_install.md) for the complete installation sequence. From a3dbd5fddb9cff5139c298c4220b031b327ab5b1 Mon Sep 17 00:00:00 2001 From: Andrea Leardini Date: Wed, 14 Jan 2026 16:53:41 +0100 Subject: [PATCH 21/22] review by gsanchietti Co-authored-by: Giacomo Sanchietti --- docs/administrator-manual/advanced/nethvoice_proxy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/administrator-manual/advanced/nethvoice_proxy.md b/docs/administrator-manual/advanced/nethvoice_proxy.md index 58edaf4..499a25a 100644 --- a/docs/administrator-manual/advanced/nethvoice_proxy.md +++ b/docs/administrator-manual/advanced/nethvoice_proxy.md @@ -73,7 +73,7 @@ In this scenario: NethVoice proxy is installed as part of the NethVoice module setup wizard. See [NethVoice Installation](../install/nethvoice_install.md) for the complete installation sequence. -### Manual Installation (not recommended): +### Manual Installation (not recommended) :::note You can install only one NethVoice Proxy per node from the Software Center. From 845b401c008c9a047b48490425906e9882effdf2 Mon Sep 17 00:00:00 2001 From: Andrea Leardini Date: Wed, 14 Jan 2026 17:12:29 +0100 Subject: [PATCH 22/22] review by gsanchietti --- docs/administrator-manual/install/nethvoice_install.md | 6 +++--- .../administrator-manual/install/nethvoice_install.md | 6 +++--- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/administrator-manual/install/nethvoice_install.md b/docs/administrator-manual/install/nethvoice_install.md index 6067ff7..cfb48e1 100644 --- a/docs/administrator-manual/install/nethvoice_install.md +++ b/docs/administrator-manual/install/nethvoice_install.md @@ -22,7 +22,7 @@ If you want a ready-to-use NethVoice installation, please consider: ## First-time setup wizard {#setup-wizard} -Open the NethVoice application from the **Applications** page or from the **Application Drawer** in NethServer 8. A first-time configuration wizard will appear and guide you through: +Open the NethVoice application from the **Applications** page or the **Application Launcher** (the 9-dot icon in the top-right corner, or press **Ctrl + Shift + A**) in NethServer 8. A first-time configuration wizard will appear and guide you through: - Configuring an account provider for NethVoice - Installing and configuring the NethVoice Proxy - Configuring the NethVoice application @@ -74,7 +74,7 @@ The proxy handles all external internet access and manages SIP/RTP traffic routi - Managing SIP and RTP connections for all NethVoice instances - SSL/TLS termination for internet-facing VoIP traffic -NethVoice Proxy is a standard NethServer 8 application: its settings can be reviewed and changed by accessing it from the **Application drawer** or from the **Applications** page. +NethVoice Proxy is a standard NethServer 8 application: its settings can be reviewed and changed by accessing it from the **Applications** page or the **Application Launcher** (the 9-dot icon in the top-right corner, or press **Ctrl + Shift + A**). #### Prerequisites @@ -147,7 +147,7 @@ https://cti.nethserver.org The settings of the NethVoice module can be reviewed and changed by accessing the NethVoice module of NethServer 8. To do this: - Access the NethServer cluster administration page. -- Open the NethVoice application from the **Application drawer** or from the **Applications** page. +- Open the NethVoice application from the **Applications** page or the **Application Launcher** (the 9-dot icon in the top-right corner, or press **Ctrl + Shift + A**). - Go to the specific configuration page you want to modify. On the **Settings** page you can review and change most of the configuration parameters: diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md index 89a3805..6323e5b 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/install/nethvoice_install.md @@ -22,7 +22,7 @@ Se desideri un'installazione di NethVoice pronta all'uso, prendi in considerazio ## Procedura guidata di configurazione iniziale {#setup-wizard} -Apri l'applicazione NethVoice dalla pagina **Applicazioni** o dal **Application Drawer** in NethServer 8. Apparirà una procedura guidata di configurazione iniziale che ti guiderà attraverso: +Apri l'applicazione NethVoice dalla pagina **Applicazioni** oppure dal **Menu Applicazioni** (icona a 9 punti in alto a destra, oppure premi **Ctrl + Shift + A**) in NethServer 8. Apparirà una procedura guidata di configurazione iniziale che ti guiderà attraverso: - Configurazione di un provider di account per NethVoice - Installazione e configurazione del NethVoice Proxy - Configurazione dell'applicazione NethVoice @@ -73,7 +73,7 @@ Il proxy gestisce tutto l'accesso esterno a Internet e il routing del traffico S - Gestione delle connessioni SIP e RTP per tutte le istanze di NethVoice - Terminazione SSL/TLS per il traffico VoIP esposto a Internet -Il NethVoice Proxy è un'applicazione standard di NethServer 8: le sue impostazioni possono essere riviste e modificate accedendo dal **Application drawer** o dalla pagina **Applicazioni**. +Il NethVoice Proxy è un'applicazione standard di NethServer 8: le sue impostazioni possono essere riviste e modificate accedendo dalla pagina **Applicazioni** oppure dal **Menu Applicazioni** (icona a 9 punti in alto a destra, oppure premi **Ctrl + Shift + A**). #### Prerequisiti {#prerequisiti} @@ -145,7 +145,7 @@ https://cti.nethserver.org Le impostazioni del modulo NethVoice possono essere riviste e modificate accedendo al modulo NethVoice di NethServer 8. Per farlo: - Accedi alla pagina di amministrazione del cluster NethServer. -- Apri l'applicazione NethVoice dall'**Application drawer** o dalla pagina **Applicazioni**. +- Apri l'applicazione NethVoice dalla pagina **Applicazioni** oppure dal **Menu Applicazioni** (icona a 9 punti in alto a destra, oppure premi **Ctrl + Shift + A**). - Vai alla pagina di configurazione specifica che desideri modificare. Nella pagina **Impostazioni** puoi rivedere e modificare la maggior parte dei parametri di configurazione: