How To: Manage Default Sites
============================

From the Default Sites page in NodeWorx, server administrators can manage the URL that a user will directed to if
they either:

- Visit a domain that points to an IP address on the server, but is not listed on the server, itself
- Visit an IP address assigned to the server from the browser

The URL of the new default site should be resolvable via DNS. 

Alternately, the default site can be ``/var/www/html``. By default, ``/var/www/html`` is an InterWorx splash page, however this 
file can be replaced by a custom index page, if desired.

While Default Sites can be managed from the GUI, the configuration file is located at 
``/etc/httpd/conf.d/vhost_000_defaults.conf``. When Default Sites is disabled, the file is renamed with .disabled 
at the end of the filename. Since the file no longer ends with .conf, it will not be loaded by Apache.

.. contents::

To Enable Default Sites
-----------------------

.. note:: 
   
   Default sites is enabled by default. 

#. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)
#. From NodeWorx, navigate to **Server > IP Management > Default Sites**

   .. image:: /images/nw-default-sites.png
      :alt: default sites pages 

#. Select **Enabled** from the Status dropdown

   .. image:: /images/default-sites-enable.png
      :alt: default sites enable option

#. Click **Save**

To Assign a New Default URL For an IP Address
---------------------------------------------

#. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)
#. From NodeWorx, navigate to **Server > IP Management > Default Sites**

   .. image:: /images/nw-default-sites.png
      :alt: default sites pages 
      
#. Click the **Pencil** next to the desired IP address. This opens the Default Sites form

   - Alternately, select the **checkbox** next to the IP address, and click **Go** next to the With Selected dropdown

   .. image:: /images/default-sites-configuration-screen.png

#. Update the **Site** field with the URL of the domain that the user will be redirected to 
   if they navigate directly to the IP address in their browser
   
   - If the field is left blank, navigating to the IP address in the browser will display ``/var/www/html/``

   .. image:: /images/default-sites-form.png
      :alt: default sites form

#. Click **Save**

To View All Domains on the Server Assigned to an IP Address
-----------------------------------------------------------

#. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)
#. From NodeWorx, navigate to **Server > IP Management > Default Sites**

   .. image:: /images/nw-default-sites.png
      :alt: default sites pages 
      
#. Click the **Magnifying Glass**. This opens the Domains On page

   .. image:: /images/nw-domains-on.png
      :alt: domains on page 
      
To Disable Default Sites
------------------------

.. warning::

   Disabling default sites may interfere with creating or renewing :doc:`SSL certificates for system services</nodeworx/server_management/other/manage-ssl-certificates-services>`
   generated with Let's Encrypt. 

#. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)
#. From NodeWorx, navigate to **Server > IP Management > Default Sites**

   .. image:: /images/nw-default-sites.png
      :alt: default sites pages 
      
#. Select **Disabled** from the Status dropdown

   .. image:: /images/default-sites-disable.png
      :alt: default sites enable option

#. Click **Save**