Skip to content

Commit a7788a7

Browse files
committed
docs: add Let's Encrypt setup step for NethVoice
Introduce a new optional section in the migration tutorial explaining how to request and enable a TLS certificate from Let's Encrypt for NethVoice. This includes prerequisites for DNS resolution and firewall accessibility, as well as simple troubleshooting notes. Also update the Italian translation with equivalent guidance and add the step to the migration process summary in both languages.
1 parent 36aab5a commit a7788a7

File tree

2 files changed

+47
-0
lines changed

2 files changed

+47
-0
lines changed

docs/tutorial/migration/start_migration.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -430,6 +430,28 @@ Update the following DNS records to point to your NS8 node:
430430
Test DNS from different locations (internal network, external network, different ISPs) to ensure proper propagation before decommissioning NS7.
431431
:::
432432

433+
### Enable Let's Encrypt Certificate for NethVoice {#enable-lets-encrypt-certificate}
434+
435+
If you want to use a TLS certificate provided by Let's Encrypt for NethVoice:
436+
437+
1. **Open NethVoice application settings**
438+
- Access the NS8 web interface
439+
- Go to your **NethVoice** application
440+
- Open the **Settings** section
441+
442+
2. **Enable Let's Encrypt certificate request**
443+
- Enable the toggle for **Request Let's Encrypt certificate**
444+
- Ensure that:
445+
- The NethVoice FQDNs resolve publicly to the NS8 node
446+
- TCP port 80 (and, if required, 443) are reachable from the Internet
447+
448+
3. **Confirm and wait for issuance**
449+
- Save the configuration
450+
- Wait for the configuration to complete
451+
- If the configuration change fails, check DNS, firewall and logs, then retry
452+
453+
Use this step only if you need (or prefer) a Let's Encrypt certificate instead of a custom certificate.
454+
433455
## Migration Process Summary {#migration-process-summary}
434456

435457
Here's the complete migration workflow:
@@ -466,6 +488,7 @@ Here's the complete migration workflow:
466488
- Point FQDNs to NS8
467489
- Verify propagation
468490
- Test access
491+
- Request a Let's Encrypt certificate (optional)
469492
470493
8. Verify and Test
471494
(See Post-Migration Steps)

i18n/it/docusaurus-plugin-content-docs/current/tutorial/migration/start_migration.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -431,6 +431,29 @@ Aggiornare i seguenti record DNS per puntare al nodo NS8:
431431
Testare il DNS da posizioni diverse (rete interna, rete esterna, ISP diversi) per assicurare una corretta propagazione prima di disattivare NS7.
432432
:::
433433

434+
### Abilitare il certificato Let's Encrypt per NethVoice
435+
436+
Se volete utilizzare un certificato TLS fornito da Let's Encrypt per NethVoice:
437+
438+
1. **Aprire le impostazioni dell'applicazione NethVoice**
439+
- Accedere all'interfaccia web di NS8
440+
- Aprire la vostra applicazione di **NethVoice**
441+
- Aprire la sezione **Impostazioni**
442+
443+
2. **Abilitare la richiesta del certificato Let's Encrypt**
444+
- Individuare la sezione TLS/Certificato
445+
- Abilitare il toggle **Richiedi certificato Let's Encrypt**
446+
- Assicurarsi che:
447+
- Gli FQDN di NethVoice risolvano pubblicamente verso il nodo NS8
448+
- La porta TCP 443 sia raggiungibile da Internet
449+
450+
3. **Confermare e attendere l'emissione**
451+
- Salvare la configurazione
452+
- Attendere che la configurazione venga applicata
453+
- Se la richiesta fallisce, verificare DNS, firewall e log, quindi riprovare
454+
455+
Usate questo passaggio solo se è necessario (o preferito) un certificato Let's Encrypt invece di un certificato personalizzato.
456+
434457
## Riepilogo del processo di migrazione
435458

436459
Ecco il flusso di lavoro completo della migrazione:
@@ -467,6 +490,7 @@ Ecco il flusso di lavoro completo della migrazione:
467490
- Puntare gli FQDN a NS8
468491
- Verificare la propagazione
469492
- Testare l'accesso
493+
- Abilitare Let's Encrypt (opzionale)
470494
471495
8. Verificare e testare
472496
(Vedere i passaggi successivi alla migrazione)

0 commit comments

Comments
 (0)