2018-07-24 07:41:41 +00:00
|
|
|
.. include:: /_includes/all.rst
|
2019-03-07 15:35:54 +00:00
|
|
|
.. include:: /_includes/snippets/__ANNOUNCEMENTS__.rst
|
2018-07-24 07:41:41 +00:00
|
|
|
|
2018-07-08 07:26:52 +00:00
|
|
|
.. _add_custom_cname_records:
|
|
|
|
|
|
|
|
|
|
****************************
|
|
|
|
|
Add custom CNAME DNS entries
|
|
|
|
|
****************************
|
|
|
|
|
|
|
|
|
|
You can add an infinite number of custom
|
2018-07-24 07:41:41 +00:00
|
|
|
|ext_lnk_wikipedia_cname| records that will be available in your
|
2018-07-08 07:26:52 +00:00
|
|
|
running Docker container.
|
|
|
|
|
If Auto-DNS is turned on, those records will be available on your host operating system as well.
|
|
|
|
|
|
|
|
|
|
.. seealso:: :ref:`setup_auto_dns`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**Table of Contents**
|
|
|
|
|
|
|
|
|
|
.. contents:: :local:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Why and what?
|
|
|
|
|
=============
|
|
|
|
|
|
|
|
|
|
This might be useful if you have an IP address or hostname on your LAN or any other domain which
|
|
|
|
|
you want to expose to your container by a different CNAME of your choice.
|
|
|
|
|
|
|
|
|
|
Think of it as setting your ``/etc/hosts``, but which will be distributed accross all hosts which
|
|
|
|
|
are using the Devilbox' bundled DNS server.
|
|
|
|
|
|
|
|
|
|
How?
|
|
|
|
|
====
|
|
|
|
|
|
|
|
|
|
Adjust the :ref:`env_extra_hosts` variable inside ``.env`` to add as many CNAME's as you need.
|
|
|
|
|
|
|
|
|
|
As an example, to create a CNAME ``mywebserver.com`` pointing to ``172.16.238.1``, change your
|
|
|
|
|
.env file as shown below:
|
|
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
:caption: .env
|
|
|
|
|
|
|
|
|
|
EXTRA_HOSTS=mywebserver.loc=172.16.238.1
|
|
|
|
|
|
|
|
|
|
.. seealso:: See :ref:`env_extra_hosts` for an in-depth explanation with multiple examples.
|
