Content add, content updates, formatting, images add. (#148)

* Create gs_wave.rst

* Update applications.rst

* images add

* Update gs_wave.rst

* Update gs_wave.rst

* Update gs_wave.rst

* Update gs_wave.rst

* Update gs_wave.rst

* Update gs_wave.rst

* Update dialplan_manager.rst

* Update dialplan_manager.rst

* Update dialplan_manager.rst

* Update dialplan_manager.rst

* Update dialplan_manager.rst

* Update dialplan_manager.rst

* Update dialplan_manager.rst

* Update dialplan_manager.rst

* Update dialplan_manager.rst

* Update dialplan_manager.rst

* Update lets_encrypt.rst

* Update lets_encrypt.rst

* Update lets_encrypt.rst

* Update getting_started.rst

* Update regex.rst

* Update lets_encrypt.rst

* Update lets_encrypt.rst

* Update lets_encrypt.rst

* Update lets_encrypt.rst

* Update lets_encrypt.rst

* Update lets_encrypt.rst

* Update lets_encrypt.rst

* Update dialplan_manager.rst

* Update dialplan_manager.rst

* Update dialplan_manager.rst

* Update dialplan_manager.rst

* Update dialplan_manager.rst

* Update dialplan_manager.rst

* Update dialplan_manager.rst

* Update dialplan_manager.rst

* Update dialplan_manager.rst

source/applications.rst

@@ -27,6 +27,7 @@ In the **Applications** menu (Apps) section you will find Call Block, Call Broad
   applications/contacts.rst
   applications/fax_server.rst
   applications/follow_me.rst
+  applications/gs_wave.rst
   applications/ivr.rst
   applications/operator_panel.rst
   applications/phrases.rst

source/applications/gs_wave.rst

@@ -0,0 +1,28 @@
+##################
+Grandstream Wave
+##################
+
+Grandstream Wave is a soft phone for smart phones or tablets. It can be configured easily with a QR code provided in your FusionPBX installation.
+
+* To use it download and install Grandstream Wave for your mobile device.
+* Start the Grandstream Wave application on your mobile device.
+* Then go to the Grandstream Wave Account Settings and press the plus+ to add a new account.
+* Press on UCM Account (Scan QR Code) and then select the extension and scan the QR code.
+
+.. image:: ../_static/images/applications/fusionpbx_applications_gs_wave.jpg
+        :scale: 85%
+
+
+You can choose any extension to provision the Grandstream Wave.  Even If the extension is assigned to a desk phone.  Just be sure to enable multiple registrations.
+
+
+.. image:: ../_static/images/applications/fusionpbx_applications_gs_wave1.jpg
+        :scale: 85%
+
+
+
+.. note::
+
+       Be sure to assign a user to an extension for this application to be fully functional. This is a new app starting with master branch version 4.5
+       
+

source/dialplan/dialplan_manager.rst

@@ -7,141 +7,273 @@ Dialplan Manager
 The dialplan is used to setup call destinations based on conditions and context. You can use the dialplan to send calls to gateways, auto attendants, external numbers, to scripts, or any destination.  
 
 
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| Dialplan Name             | Dialplan Number   | Descriptions of Dialplans                                                                              |
-+===========================+===================+========================================================================================================+
-| caller-details            |                   |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| not-found                 |                   |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| call-limit                |                   |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| speed_dial                | *0[ext]           |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| agent_status              | *22               |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| page-extension            | *8[ext]           |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| eavesdrop                 | *33[ext]          |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| send_to_voicemail         | *99[ext]          |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| cf                        | cf                |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| echo                      | *9196             |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| milliwatt                 | *9197             |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| recordings                | *732              |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| directory                 | *411              |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| user_exists               |                   |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| caller-details            |                   |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| call-direction            |                   |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| variables                 |                   |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| is_local                  |                   |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| call_block                |                   |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| user_record               |                   |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| redial                    | *870              |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| default_caller_id         |                   |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| agent_status_id           | *23               |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| provision                 | *11,*12           |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| clear_sip_auto_answer     |                   |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| nway_conference           | nway              |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| cidlookup                 |                   |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| group-intercept           | *8                |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| page                      | *724              |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| conf-xfer                 |                   |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| call_privacy              | *67[d+]           |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| call_return               | *69               |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| extension_queue           | *800[ext]         |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| intercept-ext             | **[ext]           |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| dx                        | dx                |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| att_xfer                  | att_xfer          |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| extension-to-voicemail    | [ext]             |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| vmain                     | *98               |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| xfer_vm                   | xfer_vm           |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| is_transfer               | is_transfer       |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| `vmain_user`_             | *97               |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| delay_echo                | *9195             |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| please_hold               |                   |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| is_zrtp_secure            |                   |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| is_secure                 | is_secure         |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| tone_stream               | *9198             |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| hold_music                | *9664             |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| freeswitch_conference     | *9888             |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| disa                      | *3472             |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| wake-up                   | *925              |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| extension_queue           |                   |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| valet_park                | park+*5901-*5999  |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| valet_park_in             | park+*5900        |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| valet_park_out            | park+*5901-*5999  |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| operator                  | 0                 |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| operator-forward          | *000              |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| do-not-disturb            | *77,*78,*79       |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| call-forward              | *72,*73,*74       |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| `follow-me`_              | *21               |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| `bind_digit_action`_      |                   |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| `call_screen`_            | [ext]             |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| `local_extension`_        | [ext]             |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-| `voicemail`_              | [ext]             |                                                                                                        |
-+---------------------------+-------------------+--------------------------------------------------------------------------------------------------------+
-
-
++----------------------------------+----------------------------------+
+| Dialplan Name                    | Dialplan Number                  |
++==================================+==================================+
+| `caller-details`_                |                                  |
++----------------------------------+----------------------------------+
+|   * *Details about the caller.*                                     |
++----------------------------------+----------------------------------+
+| **not-found:**                   |                                  |
++----------------------------------+----------------------------------+
+| * *Used to help trigger fail2ban from bogus calls.*                 |
++----------------------------------+----------------------------------+
+| **call-limit:**                  |                                  |
++----------------------------------+----------------------------------+
+| * *Limit calls based on number of calls and more.*                  |
++----------------------------------+----------------------------------+
+| **speed_dial:**                  | *0[ext]                          |
++----------------------------------+----------------------------------+
+| * *Uses LUA for extension speed dial.*                              |
++----------------------------------+----------------------------------+
+| **agent_status:**                | *22                              |
++----------------------------------+----------------------------------+
+| * *Agent login to call center.*                                     |
++----------------------------------+----------------------------------+
+| **page-extension:**              | *8[ext]                          |
++----------------------------------+----------------------------------+
+| * *Password protected paging of an extension.*                      |
++----------------------------------+----------------------------------+
+| **eavesdrop:**                   | *33[ext]                         |
++----------------------------------+----------------------------------+
+| * *Password protected evesdropping on extensions.*                  |
++----------------------------------+----------------------------------+
+| **send_to_voicemail:**           | *99[ext]                         |
++----------------------------------+----------------------------------+
+| * *Sending an active call to an extensions voicemail.*              |
++----------------------------------+----------------------------------+
+| **cf:**                          | cf                               |
++----------------------------------+----------------------------------+
+| *                                                                   |
++----------------------------------+----------------------------------+
+| **echo:**                        | *9196                            |
++----------------------------------+----------------------------------+
+| * *Real time echo test.*                                            |
++----------------------------------+----------------------------------+
+| **milliwatt:**                   | *9197                            |
++----------------------------------+----------------------------------+
+| * *Plays a milliwatt test tone.*                                    |
++----------------------------------+----------------------------------+
+| **recordings:**                  | *732                             |
++----------------------------------+----------------------------------+
+| * *Password protected way to record audio that can be used in*      |
+| *other applications like IVR.*                                      |
++----------------------------------+----------------------------------+
+| **directory:**                   | *411                             |
++----------------------------------+----------------------------------+
+| * *Directory of users.*                                             |
++----------------------------------+----------------------------------+
+| **user_exists:**                 |                                  |
++----------------------------------+----------------------------------+
+| * *Determines if a user exists on the switch.*                      |
++----------------------------------+----------------------------------+
+| **caller-details:**              |                                  |
++----------------------------------+----------------------------------+
+| * *Logic to decifer caller details.*                                |
++----------------------------------+----------------------------------+
+| **call-direction:**              |                                  |
++----------------------------------+----------------------------------+
+| * *Determines the direction of the call.*                           |
++----------------------------------+----------------------------------+
+| **variables:**                   |                                  |
++----------------------------------+----------------------------------+
+| * *Set variables on a domain level.*                                |
++----------------------------------+----------------------------------+
+| **is_local:**                    |                                  |
++----------------------------------+----------------------------------+
+| * *Can be used to evaluate calls as local.*                         |
++----------------------------------+----------------------------------+
+| **call_block:**                  |                                  |
++----------------------------------+----------------------------------+
+| * *Block calls from reaching endpoints.*                            |
++----------------------------------+----------------------------------+
+| **user_record:**                 |                                  |
++----------------------------------+----------------------------------+
+| * *Used to record calls.*                                           |
++----------------------------------+----------------------------------+
+| **redial:**                      | *870                             |
++----------------------------------+----------------------------------+
+| * *Dial the last number that was dialed.*                           |
++----------------------------------+----------------------------------+
+| **default_caller_id:**           |                                  |
++----------------------------------+----------------------------------+
+| * *Caller ID that can be set per domain.*                           |
++----------------------------------+----------------------------------+
+| **agent_status_id:**             | *23                              |
++----------------------------------+----------------------------------+
+| * *Status of the agent.*                                            |
++----------------------------------+----------------------------------+
+| **provision:**                   | *11,*12                          |
++----------------------------------+----------------------------------+
+| * *Used with devices.*                                              |
++----------------------------------+----------------------------------+
+| **clear_sip_auto_answer:**       |                                  |
++----------------------------------+----------------------------------+
+| *                                                                   |
++----------------------------------+----------------------------------+
+| **nway_conference**              | nway                             |
++----------------------------------+----------------------------------+
+| *                                                                   |
++----------------------------------+----------------------------------+
+| **cidlookup:**                   |                                  |
++----------------------------------+----------------------------------+
+| *                                                                   |
++----------------------------------+----------------------------------+
+| **group-intercept:**             | *8                               |
++----------------------------------+----------------------------------+
+| * *Intercepts a call from a defined group.*                         |
++----------------------------------+----------------------------------+
+| **page:**                        | *724                             |
++----------------------------------+----------------------------------+
+| * *Password protected paging defined set of extensions.*            |
++----------------------------------+----------------------------------+
+| **conf-xfer:**                   |                                  |
++----------------------------------+----------------------------------+
+| *                                                                   |
++----------------------------------+----------------------------------+
+| **call_privacy:**                | *67[d+]                          |
++----------------------------------+----------------------------------+
+| * *Send a privacy header to the carrier to hide caller id.*         |
++----------------------------------+----------------------------------+
+| **call_return:**                 | *69                              |
++----------------------------------+----------------------------------+
+| * *Call the last number that called the endpoint.*                  |
++----------------------------------+----------------------------------+
+| **extension_queue:**             | *800[ext]                        |
++----------------------------------+----------------------------------+
+| *                                                                   |
++----------------------------------+----------------------------------+
+| **intercept-ext:**               | **[ext]                          |
++----------------------------------+----------------------------------+
+| *  *Password protected intercept of an extension.*                  |
++----------------------------------+----------------------------------+
+| **dx:**                          | dx                               |
++----------------------------------+----------------------------------+
+| * *Direct transfer.*                                                |
++----------------------------------+----------------------------------+
+| **att_xfer:**                    | att_xfer                         |
++----------------------------------+----------------------------------+
+| * *Attended transfer.*                                              |
++----------------------------------+----------------------------------+
+| **extension-to-voicemail:**      | [ext]                            |
++----------------------------------+----------------------------------+
+| * *Used for extension to voicemail.*                                |
++----------------------------------+----------------------------------+
+| vmain                            | *98                              |
++----------------------------------+----------------------------------+
+| * *Main menu to access any voicemail using a pin number.*           |
++----------------------------------+----------------------------------+
+| xfer_vm                          | xfer_vm                          |
++----------------------------------+----------------------------------+
+| * *Transfer to voicemail.*                                          |
++----------------------------------+----------------------------------+
+| is_transfer                      | is_transfer                      |
++----------------------------------+----------------------------------+
+| * *Used for call transfering.*                                      |
++----------------------------------+----------------------------------+
+| `vmain_user`_                    | *97                              |
++----------------------------------+----------------------------------+
+| * *Endpoint's voicemail using a pin number.*                        |
++----------------------------------+----------------------------------+
+| delay_echo                       | *9195                            |
++----------------------------------+----------------------------------+
+| * *Play back an echo with a 5 second delay.*                        |
++----------------------------------+----------------------------------+
+| please_hold                      |                                  |
++----------------------------------+----------------------------------+
+| * *Plays an audio file when on hold.*                               |
++----------------------------------+----------------------------------+
+| is_zrtp_secure                   |                                  |
++----------------------------------+----------------------------------+
+| *                                                                   |
++----------------------------------+----------------------------------+
+| is_secure                        | is_secure                        |
++----------------------------------+----------------------------------+
+| *                                                                   |
++----------------------------------+----------------------------------+
+| tone_stream                      | *9198                            |
++----------------------------------+----------------------------------+
+| * *tones that stream and sound like Tetris music.*                  |
++----------------------------------+----------------------------------+
+| hold_music                       | *9664                            |
++----------------------------------+----------------------------------+
+| * *Play music on hold. Good for testing on an endpoint.*            |
++----------------------------------+----------------------------------+
+| freeswitch_conference            | *9888                            |
++----------------------------------+----------------------------------+
+| * *An easy way to join the Cluecon Weekly call.*                    |
++----------------------------------+----------------------------------+
+| disa                             | *3472                            |
++----------------------------------+----------------------------------+
+| * *Call in to a phone number and provide a pin to dial out.*        |
++----------------------------------+----------------------------------+
+| wake-up                          | *925                             |
++----------------------------------+----------------------------------+
+| * *Schedule date and time for an automated call.*                   |
++----------------------------------+----------------------------------+
+| extension_queue                  |                                  |
++----------------------------------+----------------------------------+
+| *                                                                   |
++----------------------------------+----------------------------------+
+| valet_park                       | park+*5901-*5999                 |
++----------------------------------+----------------------------------+
+| * *Default range to valet park calls.*                              |
++----------------------------------+----------------------------------+
+| valet_park_in                    | park+*5900                       |
++----------------------------------+----------------------------------+
+| * *Default number to send valet calls to.*                          |
++----------------------------------+----------------------------------+
+| valet_park_out                   | park+*5901-*5999                 |
++----------------------------------+----------------------------------+
+| * *Default range to retreive valet parked calls.*                   |
++----------------------------------+----------------------------------+
+| `operator`_                      | 0                                |
++----------------------------------+----------------------------------+
+| * *Configurable option for an operator.*                            |
++----------------------------------+----------------------------------+
+| `operator-forward`_              | *000                             |
++----------------------------------+----------------------------------+
+| * *Uses dial_string.lua.*                                           |
++----------------------------------+----------------------------------+
+| `do-not-disturb`_                | *77,*78,*79                      |
++----------------------------------+----------------------------------+
+| * *Turn on, toggle, turn off do not disturb.*                       |
++----------------------------------+----------------------------------+
+| `call-forward`_                  | *72,*73,*74                      |
++----------------------------------+----------------------------------+
+| * *Turn on, toggle on/off and turn off call forwarding.*            |
++----------------------------------+----------------------------------+
+| `follow-me`_                     | *21                              |
++----------------------------------+----------------------------------+
+| * *Forwards call to defined list of phone numbers or extensions.*   |
++----------------------------------+----------------------------------+
+| `bind_digit_action`_             |                                  |
++----------------------------------+----------------------------------+
+| *                                                                   |
++----------------------------------+----------------------------------+
+| `call_screen`_                   | [ext]                            |
++----------------------------------+----------------------------------+
+| * *Play an audio file and give options to the caller to record a*   |
+| *short message for the call recipient. Call recipient can then*     |
+| *accept or reject the call.*                                        |
++----------------------------------+----------------------------------+
+| `local_extension`_               | [ext]                            |
++----------------------------------+----------------------------------+
+| * *Examines to see if the extension is local.*                      |
++----------------------------------+----------------------------------+
+| `voicemail`_                     | [ext]                            |
++----------------------------------+----------------------------------+
+| *  *Voicemail for extensions.*                                      |
++----------------------------------+----------------------------------+
 
+.. _operator: dialplan_details.html#operator 
+.. _operator-forward: dialplan_details.html#operator-forward
+.. _do-not-disturb: dialplan_details.html#do-not-disturb
+.. _call-forward: dialplan_details.html#call-forward
 .. _call_screen: dialplan_details.html#call-screen
 .. _local_extension: dialplan_details.html#local-extension
 .. _voicemail: dialplan_details.html#voicemail
 .. _vmain_user: /en/latest/dialplan/dialplan_details.html#voicemail-vmain-user
 .. _bind_digit_action: dialplan_details.html#bind-digit-action
 .. _follow-me: dialplan_details.html#follow-me
+.. _caller-details: dialplan_details.html#caller-details

source/getting_started.rst

@@ -18,6 +18,7 @@ Follow the menu to the left and you will have a working PBX in no time. For PDF
 
   getting_started/training.rst
   getting_started/quick_install.rst
+  getting_started/lets_encrypt.rst
   applications/provision.rst
   getting_started/security.rst
   getting_started/backup.rst

source/getting_started/lets_encrypt.rst

@@ -1,7 +1,199 @@
+***************
 Let's Encrypt
-==============
+***************
 
-Let's Encrypt is one of the most recent and widely used form of free SSL security but doesn't support wildcard DNS.  You can use Let's Encrypt with your FusionPBX install and WebRTC like `Verto Communicator`_.
+Let's Encrypt is one of the most recent and widely used form of free SSL security and supports wildcard DNS.  You can use Let's Encrypt with your FusionPBX install and WebRTC like `Verto Communicator`_.
+
+
+Dehydrated (Recommended)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+FusionPBX has an option to easliy and quickly install SSL with Let's Encrypt using **letsencrypt.sh**  With this script you can choose either to request an SSL certificate with wildcard (*.domain.tld) or hostnames (domain.tld).
+
+The letsencrypt.sh will do the following:
+
+* Download `dehydrated <https://github.com/lukas2511/dehydrated>`_.
+* Request an SSL certificate from `Let's Encrypt <https://letsencrypt.com>`_.
+* Configure NGINX to use the SSL certificate.
+* Combine and place SSL certificate in the proper `FreeSWITCH <https://freeswitch.org/confluence/display/FREESWITCH/FreeSWITCH+Explained>`_ directory for using TLS.
+* Test and make sure the SSL cert works and outputs if sucessful.
+
+Using letsencrypt.sh
+---------------------
+
+With letsencrypt.sh you have the choice of creating an SSL certificate for a single domain (domain.tld), multiple sub domains(sub.domain.tld, sub1.domain.tld, etc.domain.tld) or wildcard (*.domain.tld).  The easy way however is using the hostname method. 
+
+Hostname
+~~~~~~~~~~
+
+To create a hostname or multiple hostname SSL certificate go to:
+
+::
+
+ cd /usr/src/fusionpbx-install.sh/debian/resources/
+
+Then execute the script.
+
+::
+
+ ./letsencrypt.sh
+ 
+ 
+You should then see and follow the prompts.
+
+::
+
+ Domain Name: domain.tld
+ Email Address: [email protected]
+
+After that, you should see the following output.
+
+::
+
+ Cloning into 'dehydrated'...
+ remote: Counting objects: 1914, done.
+ remote: Total 1914 (delta 0), reused 0 (delta 0), pack-reused 1914
+ Receiving objects: 100% (1914/1914), 616.01 KiB | 0 bytes/s, done.
+ Resolving deltas: 100% (1199/1199), done.
+ # INFO: Using main config file /etc/dehydrated/config
+ + Generating account key...
+ + Registering account key with ACME server...
+ + Done!
+ # INFO: Using main config file /etc/dehydrated/config
+ + Creating chain cache directory /etc/dehydrated/chains
+ Processing domain.tld
+ + Creating new directory /etc/dehydrated/certs/domain.tld ...
+ + Signing domains...
+ + Generating private key...
+ + Generating signing request...
+ + Requesting new certificate order from CA...
+ + Received 1 authorizations URLs from the CA
+ + Handling authorization for domain.tld
+ + 1 pending challenge(s)
+ + Deploying challenge tokens...
+ + Responding to challenge for domain.tld authorization...
+ + Challenge is valid!
+ + Cleaning challenge tokens...
+ + Requesting certificate...
+ + Checking certificate...
+ + Done!
+ + Creating fullchain.pem...
+ + Done!
+ 
+ nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
+ nginx: configuration file /etc/nginx/nginx.conf test is successful
+
+
+Wildcard
+~~~~~~~~~~~
+
+To create a wildcard SSL certificate go to:
+
+::
+
+ cd /usr/src/fusionpbx-install.sh/debian/resources/
+
+
+Then execute the script.
+
+::
+
+ ./letsencrypt.sh
+
+You should then see and follow the prompts:
+
+::
+
+ Domain Name: *.domain.tld
+ Email Address: [email protected]
+ 
+::
+
+ Cloning into 'dns-01-manual'...
+ remote: Counting objects: 9, done.
+ remote: Total 9 (delta 0), reused 0 (delta 0), pack-reused 9
+ Unpacking objects: 100% (9/9), done.
+ Checking connectivity... done.
+ # INFO: Using main config file /etc/dehydrated/config
+ + Account already registered!
+ # INFO: Using main config file /etc/dehydrated/config
+ Processing *.domain.tld
+ + Checking domain name(s) of existing cert... changed!
+ + Domain name(s) are not matching!
+ + Names in old certificate: domain.tld
+ + Configured names: *.domain.tld
+ + Forcing renew.
+ + Checking expire date of existing cert...
+ + Valid till Nov 19 16:08:32 2018 GMT (Longer than 30 days). Ignoring because renew was forced!
+ + Signing domains...
+ + Generating private key...
+ + Generating signing request...
+ + Requesting new certificate order from CA...
+ + Received 1 authorizations URLs from the CA
+ + Handling authorization for domain.tld
+ + 1 pending challenge(s)
+ + Deploying challenge tokens...
+
+
+.. note::
+
+      When you define the txt record with your domain registrar be sure to use the output of the script you are running and not what is in this example.
+
+::
+
+ Add the following to the zone definition of domain.tld:
+ _acme-challenge.domain.tld. IN TXT "PY7ttk6no_5eG7WtAbO6qs5-NzA-Kigko375omKc0nw"
+
+ **Press enter to continue...**
+
+::
+
+ + Responding to challenge for domain.tld authorization...
+ + Challenge is valid!
+ + Cleaning challenge tokens...
+
+::
+
+ Now you can remove the following from the zone definition of domain.tld:
+ _acme-challenge.domain.tld. IN TXT "PY7ttk6no_5eG7WtAbO6qs5-NzA-Kigko375omKc0nw"
+
+ **Press enter to continue...**
+
+::
+
+ + Requesting certificate...
+ + Checking certificate...
+ + Done!
+ + Creating fullchain.pem...
+
+ deploy_cert()
+
+ Done!
+
+ **done**
+
+ nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
+ nginx: configuration file /etc/nginx/nginx.conf test is successful
+
+.. tip::
+
+       Use the dig command to check that the txt record is correct.  dig -t txt _acme-challenge.domain.tld
+       
+       Output should show:
+       
+       ;; ANSWER SECTION:
+       _acme-challenge.domain.tld. 1799 IN TXT  "PY7ttk6no_5eG7WtAbO6qs5-NzA-Kigko375omKc0nw"
+
+
+
+
+
+
+
+Certbot (Alternative Option)
+^^^^^^^^^^^^^^^^^^^^
+
+Certbot is optional and is more of a manual way of using Let's Encrypt SSL.  Some still use this process but most use the recommended way with the Dehydrated script.
 
 More info on NGINX with Let's Encrypt
 https://www.nginx.com/blog/free-certificates-lets-encrypt-and-nginx