[IMP] maintain: domain names
task-3595179
closes odoo/documentation#7885
X-original-commit: f9edbcd6b5
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
This commit is contained in:
Donatienne (dopi)
Xavier (XPL)
parent
25b787e8bc
commit
e4def45a33
@ -2,293 +2,255 @@
|
|||||||
Domain names
|
Domain names
|
||||||
============
|
============
|
||||||
|
|
||||||
A **domain name** works as an address for your website. It makes the Internet much more accessible
|
Domain names are text-based addresses identifying online locations, such as websites. They provide a
|
||||||
as it allows users to type a meaningful web address, such as ``www.odoo.com``, rather than its
|
more memorable and recognizable way for people to navigate the internet than numerical IP addresses.
|
||||||
server's IP address with a series of numbers.
|
|
||||||
|
|
||||||
You can use a custom domain name to access your Odoo database and websites:
|
**Odoo Online** and **Odoo.sh** databases use a **subdomain** of the `odoo.com` **domain** by
|
||||||
|
default (e.g., `mycompany.odoo.com`).
|
||||||
|
|
||||||
- By :ref:`registering a free domain name with Odoo <domain-name/odoo-register>` (for Odoo Online
|
However, you can use a custom domain name instead by :ref:`registering a free domain name
|
||||||
databases)
|
<domain-name/register>` (only available for Odoo Online databases) or by :ref:`configuring a
|
||||||
- By :ref:`configuring a custom domain that you already own <domain-name/existing>`.
|
domain name you already own <domain-name/existing>`.
|
||||||
|
|
||||||
.. note::
|
|
||||||
Odoo Online and Odoo.sh databases, including their websites, use by default a subdomain of
|
|
||||||
``odoo.com`` for both the URL and the emails (e.g., ``https://example.odoo.com``).
|
|
||||||
|
|
||||||
.. important::
|
|
||||||
Odoo offers a :ref:`free custom domain name <domain-name/odoo-register>` to all Odoo Online
|
|
||||||
databases for one year. Visitors can then access your website with an address such as
|
|
||||||
``www.example.com`` rather than the default ``example.odoo.com``.
|
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
- `Odoo Tutorials: Register a Free Domain Name
|
`Odoo Tutorials: Register a free domain name [video]
|
||||||
<https://www.odoo.com/slides/slide/register-a-free-domain-name-1663>`_
|
<https://www.odoo.com/slides/slide/register-a-free-domain-name-1663>`_
|
||||||
- `Odoo Quick Tips: Get a free domain name! <https://www.youtube.com/watch?v=eAfgeNOHLP4>`_
|
|
||||||
|
|
||||||
.. _domain-name/about:
|
.. _domain-name/register:
|
||||||
|
|
||||||
About domain names
|
|
||||||
==================
|
|
||||||
|
|
||||||
Having a **good domain name** is as important to your branding as the name of your business or
|
|
||||||
organization as it is the first thing your visitors will notice. We recommend you keep them *simple,
|
|
||||||
short, easy to remember and spell*.
|
|
||||||
|
|
||||||
A **subdomain** is a domain that is a part of another domain. It often refers to the additional part
|
|
||||||
that comes before the main domain name. Traditionally, most websites use the ``www.`` subdomain,
|
|
||||||
but any string of letters can be used as well. You can use subdomains to direct your visitors to
|
|
||||||
other websites than your main website or to specific pages (e.g., ``experience.odoo.com`` points to
|
|
||||||
a specific page.)
|
|
||||||
|
|
||||||
All domain names are referenced in the **Domain Name System**, or **DNS**, which works as a giant
|
|
||||||
directory for the Internet. There are many DNS servers, so any modification to the DNS can take up
|
|
||||||
to 72 hours to propagate worldwide on all servers.
|
|
||||||
|
|
||||||
.. _domain-name/indexing:
|
|
||||||
|
|
||||||
Indexing of domain names by search engines
|
|
||||||
------------------------------------------
|
|
||||||
|
|
||||||
Search engines, such as Google and Bing, rely on web crawlers (:dfn:`robots that explore and analyze
|
|
||||||
the web`) to index all websites and their related domain names. These crawlers discover new URLs
|
|
||||||
thanks to links on known web pages. As a result, search engines should index domain names
|
|
||||||
automatically after a while, as long as their URLs are mentioned elsewhere on the Internet.
|
|
||||||
|
|
||||||
Improving the appearance and positioning of web pages on search engines is a practice named "Search
|
|
||||||
Engine Optimization" (SEO).
|
|
||||||
|
|
||||||
.. tip::
|
|
||||||
Adding relevant content, optimizing metadata, and building high-quality backlinks can all help
|
|
||||||
improve a website's search engine visibility.
|
|
||||||
|
|
||||||
Some search engines provide tools for web admins, such as
|
|
||||||
`Google Search Console <https://search.google.com/search-console>`_ and
|
|
||||||
`Bing Webmaster Tools <https://www.bing.com/webmasters>`_, to help you analyze and improve your
|
|
||||||
page ranking. To use these services, you must prove that you are the owner of your domain name. One
|
|
||||||
way to verify the ownership of your domain name is by adding a DNS record. You can do this for
|
|
||||||
:ref:`domain names registered with Odoo <domain-name/odoo-manage>` and for domain names managed by
|
|
||||||
other providers.
|
|
||||||
|
|
||||||
.. seealso::
|
|
||||||
- :doc:`/applications/websites/website/pages/seo`
|
|
||||||
- `Google Search Console Help - Verify your site ownership <https://support.google.com/webmasters/answer/9008080>`_
|
|
||||||
- `Bing Webmaster Tools - Add and Verify site <https://www.bing.com/webmasters/help/add-and-verify-site-12184f8b>`_
|
|
||||||
|
|
||||||
.. _domain-name/odoo-register:
|
|
||||||
|
|
||||||
Register a free domain name with Odoo
|
Register a free domain name with Odoo
|
||||||
=====================================
|
=====================================
|
||||||
|
|
||||||
You can register a domain name for your Odoo Online database directly from Odoo Website or your
|
To register a one-year free domain name for your Odoo Online database, sign in to your account and
|
||||||
database manager.
|
go to the `database manager <https://www.odoo.com/my/databases>`_. Click the gear icon
|
||||||
|
(:guilabel:`⚙️`) next to the database name and select :guilabel:`Domain Names`.
|
||||||
|
|
||||||
|
.. image:: domain_names/domain-names.png
|
||||||
|
:alt: Accessing a database's domain names configuration
|
||||||
|
|
||||||
|
Search for the desired domain name and check its availability.
|
||||||
|
|
||||||
|
.. image:: domain_names/domain-search.png
|
||||||
|
:alt: Searching for an available domain name
|
||||||
|
|
||||||
|
.. tip::
|
||||||
|
Ensure the Website app is installed if the domain name registration option does not appear.
|
||||||
|
|
||||||
|
Select the desired domain name, fill in the :guilabel:`Domain Owner` form, and click
|
||||||
|
:guilabel:`Register`. The chosen domain name is directly linked to the database, but you still need
|
||||||
|
to :ref:`map your domain name to your Odoo website <domain-name/db-map>`.
|
||||||
|
|
||||||
|
.. image:: domain_names/domain-owner.png
|
||||||
|
:alt: Filling in the domain owner information
|
||||||
|
|
||||||
.. important::
|
.. important::
|
||||||
- Your domain name is **free for one year** if you register it with Odoo!
|
A verification email from `noreply@domainnameverification.net` will be sent to the email address
|
||||||
- The domain name is registered with `Gandi <https://www.gandi.net/>`_, the domain name
|
provided in the :guilabel:`Domain Owner` form. It is essential to verify your email address to
|
||||||
registrar.
|
keep the domain active and receive the renewal quote before expiration.
|
||||||
- You are the owner of the domain name and can use it for other purposes.
|
|
||||||
- Odoo manages payment and technical support for you.
|
|
||||||
- This offer doesn't include any mailbox. However, you can :ref:`configure your MX records
|
|
||||||
<domain-name/odoo-manage>` to use your own email server or solution such as Google Workspace.
|
|
||||||
|
|
||||||
To do so, go to :menuselection:`Website --> Domain Name`. Alternatively, open your `database manager
|
The domain name registration is free for the first year. After this period, Odoo will continue to
|
||||||
<https://www.odoo.com/my/databases>`_, click on the :guilabel:`settings` button next to your
|
manage the domain in partnership with **Gandi.net**, the domain name registrar, and you will be
|
||||||
database, then on :guilabel:`Domain names`.
|
charged `Gandi.net's renewal rate <https://www.gandi.net/en/domain>`_. Odoo sends a renewal
|
||||||
|
quotation every year to the email address mentioned in the :guilabel:`Domain Owner` form several
|
||||||
.. image:: domain_names/register-menu.png
|
weeks before the expiration date of the domain. The domain is renewed automatically when the
|
||||||
:align: center
|
quotation is confirmed.
|
||||||
:alt: Clicking on Domain Names from an Odoo website
|
|
||||||
|
|
||||||
Search for the domain name of your choice to check its availability, then select the one you want to
|
|
||||||
register for your website.
|
|
||||||
|
|
||||||
.. image:: domain_names/register-search.png
|
|
||||||
:align: center
|
|
||||||
:alt: The search of the domain name example.com shows which associated domains are available.
|
|
||||||
|
|
||||||
Next, fill in the form with your information to become the domain name owner.
|
|
||||||
|
|
||||||
Your domain name is directly linked to your database, but you still have to :ref:`map your domain
|
|
||||||
name with your website <domain-name/website-map>`.
|
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
- Free domain names are also available for free Odoo Online databases (if you installed one app
|
- The offer is only available for **Odoo Online** databases.
|
||||||
only, for example). In this case, Odoo reviews your request and your website to avoid abuse.
|
- The offer is limited to **one** domain name per client.
|
||||||
This process can take several days due to the success of the offer.
|
- The offer is limited to the registration of a **new** domain name.
|
||||||
- This is not available for Odoo.sh databases yet.
|
- The offer is available to *One App Free* plans. Ensure that your website contains enough
|
||||||
|
original content for Odoo to verify that your request is legitimate and respects `Odoo's
|
||||||
|
Acceptable Use Policy <https://www.odoo.com/acceptable-use>`_. Given the high number of
|
||||||
|
requests, it can take Odoo several days to review them.
|
||||||
|
|
||||||
.. _domain-name/odoo-manage:
|
.. _domain-name/register-dns:
|
||||||
|
|
||||||
Manage your domain name registered with Odoo
|
DNS records
|
||||||
--------------------------------------------
|
-----------
|
||||||
|
|
||||||
To manage the DNS records of your domain name registered with Odoo or to visualize the contacts
|
To manage your free domain name :abbr:`DNS (domain name system)` records, open the `database manager
|
||||||
associated with it, open your `database manager <https://www.odoo.com/my/databases>`_, click on the
|
<https://www.odoo.com/my/databases>`_, click the gear icon (:guilabel:`⚙️`) next to the database
|
||||||
:guilabel:`settings` button next to your database, on :guilabel:`Domain names`, and then on
|
name, select :guilabel:`Domain Names`, and click :guilabel:`DNS`.
|
||||||
:guilabel:`Contacts` or :guilabel:`DNS`.
|
|
||||||
|
|
||||||
.. image:: domain_names/manage.png
|
- :guilabel:`A`: the A record holds the IP address of the domain. It is automatically created and
|
||||||
:align: center
|
**cannot** be edited or deleted.
|
||||||
:alt: Management of the domain names linked to an Odoo database
|
- :guilabel:`CNAME`: CNAME records forward one domain or subdomain to another domain. One is
|
||||||
|
automatically created to map the `www.` subdomain to the database. If the database is renamed, the
|
||||||
|
CNAME record **must** also be renamed.
|
||||||
|
- :guilabel:`MX`: MX records instruct servers on where to deliver emails.
|
||||||
|
- :guilabel:`TXT`: TXT records can be used for different purposes (e.g., to verify domain name
|
||||||
|
ownership).
|
||||||
|
|
||||||
|
Any modification to the DNS records can take up to **72 hours** to propagate worldwide on all
|
||||||
|
servers.
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
Please `submit a support ticket <https://www.odoo.com/help>`_ if you need further assistance to
|
`Submit a support ticket <https://www.odoo.com/help>`_ if you need assistance to manage your
|
||||||
manage your domain name.
|
domain name.
|
||||||
|
|
||||||
|
Mailbox
|
||||||
|
-------
|
||||||
|
|
||||||
|
The one-year free domain name offer does **not** include a mailbox. There are two options to link
|
||||||
|
your domain name with a mailbox.
|
||||||
|
|
||||||
|
Use a subdomain
|
||||||
|
~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
You can create a subdomain (e.g., `subdomain.yourdomain.com`) to use as an alias domain for the
|
||||||
|
database. It allows users to create records in the database from emails received on their
|
||||||
|
`email@subdomain.yourdomain.com` alias.
|
||||||
|
|
||||||
|
To do so, open the `database manager <https://www.odoo.com/my/databases>`_, click the gear icon
|
||||||
|
(:guilabel:`⚙️`) next to the database name, and go to :menuselection:`Domain Names --> DNS --> Add
|
||||||
|
DNS record --> CNAME`. Next, enter the desired subdomain in the :guilabel:`Name` field (e.g.,
|
||||||
|
`subdomain`), the original database domain with a period at the end (e.g., `mycompany.odoo.com.`) in
|
||||||
|
the :guilabel:`Content` field, and click :guilabel:`Add record`.
|
||||||
|
|
||||||
|
Then, add the alias domain as your *own domain* by clicking :guilabel:`Use my own domain`, entering
|
||||||
|
the alias domain (e.g., `subdomain.yourdomain.com`), clicking :guilabel:`Verify`, and then
|
||||||
|
:guilabel:`I confirm, it's done`.
|
||||||
|
|
||||||
|
Finally, go to your database and open the :guilabel:`Settings`. Under the :guilabel:`Alias Domain`
|
||||||
|
field, enter the alias domain (e.g., `subdomain.yourdomain.com`), click :guilabel:`Create`, and then
|
||||||
|
:guilabel:`Save`.
|
||||||
|
|
||||||
|
Use an external email provider
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
To use an external email provider, you should configure an MX record. To do so, open the `database
|
||||||
|
manager <https://www.odoo.com/my/databases>`_, click the gear icon (:guilabel:`⚙️`) next to the
|
||||||
|
database name, click :menuselection:`Domain Names --> DNS --> Add DNS record --> MX`. The values you
|
||||||
|
should enter for the :guilabel:`Name`, :guilabel:`Content`, and :guilabel:`Priority` fields depend
|
||||||
|
on the external email provider.
|
||||||
|
|
||||||
|
.. seealso::
|
||||||
|
- `Google Workspace: MX record values <https://support.google.com/a/answer/174125?hl=en>`_
|
||||||
|
- `Outlook and Exchange Online: Add an MX record for email <https://learn.microsoft.com/en-us/microsoft-365/admin/get-help-with-domains/create-dns-records-at-any-dns-hosting-provider?view=o365-worldwide#add-an-mx-record-for-email-outlook-exchange-online>`_
|
||||||
|
|
||||||
.. _domain-name/existing:
|
.. _domain-name/existing:
|
||||||
|
|
||||||
Configure your existing domain name
|
Configure an existing domain name
|
||||||
===================================
|
=================================
|
||||||
|
|
||||||
If you already own a domain name, you can use it to point to your website.
|
If you already have a domain name, you can use it for your Odoo website.
|
||||||
|
|
||||||
To avoid any issue with the :ref:`SSL certificate validation <domain-name/ssl>`, we highly recommend
|
.. warning::
|
||||||
that you proceed with the following actions in this order:
|
It is strongly recommended to follow **in order** these three steps to avoid any :ref:`SSL
|
||||||
|
certificate validation <domain-name/ssl>` issues:
|
||||||
|
|
||||||
#. :ref:`Add a CNAME record <domain-name/cname>` on your domain name's DNS zone.
|
#. :ref:`Add a CNAME record <domain-name/cname>`
|
||||||
#. :ref:`Map your domain name with your Odoo database <domain-name/db-map>`.
|
#. :ref:`Map your domain name to your Odoo database <domain-name/db-map>`
|
||||||
#. :ref:`Map your domain name with your Odoo website <domain-name/website-map>`.
|
#. :ref:`Map your domain name to your Odoo website <domain-name/website-map>`
|
||||||
|
|
||||||
.. _domain-name/cname:
|
.. _domain-name/cname:
|
||||||
|
|
||||||
Add a CNAME record
|
Add a CNAME record
|
||||||
------------------
|
------------------
|
||||||
|
|
||||||
A **CNAME record** is a type of DNS record that points to the domain of another website rather than
|
Creating a CNAME record to forward your domain name to the address of your Odoo database is
|
||||||
directly to an IP address.
|
required.
|
||||||
|
|
||||||
You need a CNAME record that points to your Odoo database. The requirements are detailed in your
|
|
||||||
database manager.
|
|
||||||
|
|
||||||
.. tabs::
|
.. tabs::
|
||||||
|
|
||||||
.. group-tab:: Odoo Online
|
.. group-tab:: Odoo Online
|
||||||
|
|
||||||
The target address is the current address of your database, as defined at its creation (e.g.,
|
The CNAME record's target address should be your database's address as defined at its creation
|
||||||
``example.odoo.com``)
|
(e.g., `mycompany.odoo.com`).
|
||||||
|
|
||||||
.. group-tab:: Odoo.sh
|
.. group-tab:: Odoo.sh
|
||||||
|
|
||||||
Your project's main address is defined in :menuselection:`Settings --> Project Name`.
|
The CNAME record's target address can be the project's main address, which can be found on
|
||||||
|
Odoo.sh by going to :menuselection:`Settings --> Project Name`, or a specific branch
|
||||||
|
(production, staging or development) by going to :menuselection:`Branches --> select the
|
||||||
|
branch --> Settings --> Custom domains`, and clicking :guilabel:`How to set up my domain?`. A
|
||||||
|
message indicates which address your CNAME record should target.
|
||||||
|
|
||||||
If you want to target a specific branch (production, staging or development), go to
|
The specific instructions depend on your DNS hosting service.
|
||||||
:menuselection:`Branches --> select your branch --> Settings --> Custom domains`, and click on
|
|
||||||
:guilabel:`How to set up my domain?`. A message indicates which address your CNAME record
|
|
||||||
should target.
|
|
||||||
|
|
||||||
#. Open your domain name's manager dashboard.
|
.. seealso::
|
||||||
#. Open the **DNS zone** management page for the domain name you want to configure.
|
- `GoDaddy: Add a CNAME record <https://www.godaddy.com/help/add-a-cname-record-19236>`_
|
||||||
#. Create a **CNAME record** pointing to the address of your database.
|
- `Namecheap: How to create a CNAME record for your domain <https://www.namecheap.com/support/knowledgebase/article.aspx/9646/2237/how-to-create-a-cname-record-for-your-domain>`_
|
||||||
|
- `OVHcloud: Add a new DNS record <https://docs.ovh.com/us/en/domains/web_hosting_how_to_edit_my_dns_zone/#add-a-new-dns-record>`_
|
||||||
|
- `Cloudflare: Manage DNS records
|
||||||
|
<https://support.cloudflare.com/hc/en-us/articles/360019093151>`_
|
||||||
|
|
||||||
While Odoo suggests creating a CNAME record for your ``www.`` subdomain (``www.example.com``), you
|
Creating a CNAME record to map the `www` subdomain (`www.yourdomain.com`) as some visitors are used
|
||||||
can of course use any domain name of your choice, with any subdomain (e.g.,
|
to typing `www.` before entering a domain name.
|
||||||
``anything.example.com``).
|
|
||||||
|
|
||||||
.. example::
|
.. example::
|
||||||
You own the domain name ``example.com``, and you have an Odoo Online database at the address
|
You own the domain name `yourdomain.com`, and your Odoo Online database's address is
|
||||||
``example.odoo.com``. You want to access your Odoo database primarily with the domain
|
`mycompany.odoo.com`. You want to access your Odoo database primarily with the domain
|
||||||
``www.example.com`` but also with the :ref:`naked domain <domain-name/naked-domain>`
|
`www.yourdomain.com` but also with the naked domain :dfn:`(a domain name without any subdomains
|
||||||
``example.com``.
|
or prefixes)` `yourdomain.com`.
|
||||||
|
|
||||||
To do so, you create a CNAME record for the ``www`` subdomain, with ``example.odoo.com`` as the
|
To do so, create a CNAME record for the `www` subdomain, with `mycompany.odoo.com` as the
|
||||||
target. The DNS zone manager generates the following rule and adds it to your DNS zone: ``www IN
|
target. Next, create a redirect (301 permanent or visible redirect) to redirect visitors from
|
||||||
CNAME example.odoo.com.``
|
`yourdomain.com` to `wwww.yourdomain.com`.
|
||||||
|
|
||||||
You also create a redirection from ``example.com`` to ``wwww.example.com``.
|
|
||||||
|
|
||||||
Your new DNS records are propagated to all DNS servers.
|
|
||||||
|
|
||||||
.. note::
|
|
||||||
Here are some specific guidelines to create a CNAME record:
|
|
||||||
|
|
||||||
- `GoDaddy <https://www.godaddy.com/help/add-a-cname-record-19236>`_
|
|
||||||
- `Namecheap <https://www.namecheap.com/support/knowledgebase/article.aspx/9646/2237/how-to-create-a-cname-record-for-your-domain>`_
|
|
||||||
- `OVH <https://docs.ovh.com/us/en/domains/web_hosting_how_to_edit_my_dns_zone/#add-a-new-dns-record>`_
|
|
||||||
- `CloudFlare <https://support.cloudflare.com/hc/en-us/articles/360019093151>`_
|
|
||||||
- `Google Domains <https://support.google.com/domains/answer/3290350?hl=en>`_
|
|
||||||
|
|
||||||
.. _domain-name/naked-domain:
|
|
||||||
|
|
||||||
Naked domain
|
|
||||||
~~~~~~~~~~~~
|
|
||||||
|
|
||||||
A **naked domain** is a domain name that doesn't have any subdomain at the beginning of the address
|
|
||||||
(e.g., ``odoo.com`` instead of ``www.odoo.com``).
|
|
||||||
|
|
||||||
You may want your naked domain to redirect to your website as some visitors may not type the full
|
|
||||||
domain name to access your website.
|
|
||||||
|
|
||||||
#. Open your domain name's manager dashboard.
|
|
||||||
#. Create a **redirection** from the naked domain (``example.com``) to your main domain name
|
|
||||||
(``www.example.com``).
|
|
||||||
|
|
||||||
.. note::
|
|
||||||
Depending on your domain name registrar, this redirection may be already pre-configured.
|
|
||||||
|
|
||||||
.. _domain-name/db-map:
|
.. _domain-name/db-map:
|
||||||
|
|
||||||
Map your domain name with your Odoo database
|
Map a domain name to an Odoo database
|
||||||
--------------------------------------------
|
-------------------------------------
|
||||||
|
|
||||||
|
.. warning::
|
||||||
|
Ensure you have :ref:`added a CNAME record <domain-name/cname>` to your domain name's DNS
|
||||||
|
**before** mapping your domain name to your Odoo database.
|
||||||
|
|
||||||
|
Failing to do so may prevent the validation of the :ref:`SSL certificate <domain-name/ssl>` and
|
||||||
|
could result in a *certificate name mismatch* error. Web browsers often display this as a
|
||||||
|
warning, such as *"Your connection is not private"*.
|
||||||
|
|
||||||
|
If you encounter this error after mapping the domain name to your database, wait up to five
|
||||||
|
days, as the validation may still happen. If not, you can `submit a support ticket
|
||||||
|
<https://www.odoo.com/help>`_, including screenshots of your CNAME records.
|
||||||
|
|
||||||
.. tabs::
|
.. tabs::
|
||||||
|
|
||||||
.. group-tab:: Odoo Online
|
.. group-tab:: Odoo Online
|
||||||
|
|
||||||
Open your `database manager <https://www.odoo.com/my/databases>`_, click on the
|
Open the `database manager <https://www.odoo.com/my/databases>`_, click the gear icon
|
||||||
:guilabel:`settings` button next to your database, on :guilabel:`Domain names`, and then on
|
(:guilabel:`⚙️`) next to the database name, and go to :menuselection:`Domain Names --> Use my
|
||||||
:guilabel:`Use my own domain` at the bottom of the right column.
|
own domain`. Then, enter the domain name (e.g., `yourdomain.com`), click :guilabel:`Verify`
|
||||||
|
and :guilabel:`I confirm, it's done`.
|
||||||
|
|
||||||
Type the domain name you want to add to this database, then click on :guilabel:`Verify` to
|
.. image:: domain_names/map-database-online.png
|
||||||
check if the CNAME record is correctly configured. Once done, click on :guilabel:`I confirm,
|
:alt: Mapping a domain name to an Odoo Online database
|
||||||
it's done`.
|
|
||||||
|
|
||||||
.. image:: domain_names/online-map.png
|
|
||||||
:align: center
|
|
||||||
:alt: Verification of the CNAME records of a domain name before mapping it with a database
|
|
||||||
|
|
||||||
.. group-tab:: Odoo.sh
|
.. group-tab:: Odoo.sh
|
||||||
|
|
||||||
Go to :menuselection:`Branches --> select your branch --> Settings --> Custom domains`, type
|
On Odoo.sh, go to :menuselection:`Branches --> select your branch --> Settings --> Custom
|
||||||
the domain name you want to add to this database, then click on :guilabel:`Add domain`.
|
domains`, type the domain name to add, then click :guilabel:`Add domain`.
|
||||||
|
|
||||||
.. image:: domain_names/odoo-sh-map.png
|
.. image:: domain_names/map-database-sh.png
|
||||||
:align: center
|
:alt: Mapping a domain name to an Odoo.sh branch
|
||||||
:alt: Mapping a domain name with an Odoo.sh branch
|
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
- :ref:`Odoo.sh branches: settings tab <odoosh-gettingstarted-branches-tabs-settings>`
|
:ref:`Odoo.sh branches: settings tab <odoosh-gettingstarted-branches-tabs-settings>`
|
||||||
|
|
||||||
.. warning::
|
|
||||||
Make sure to :ref:`add a CNAME record <domain-name/cname>` to your domain name's DNS **before**
|
|
||||||
mapping your domain name with your Odoo database.
|
|
||||||
|
|
||||||
Failing to do so may impede the validation of the :ref:`SSL certificate <domain-name/ssl>` and
|
|
||||||
would result in a *certificate name mismatch* error. This is often displayed by web browsers as a
|
|
||||||
warning such as *"Your connection is not private"*.
|
|
||||||
|
|
||||||
If this is the case and you have added the domain name to your database's settings less than five
|
|
||||||
days ago, wait 24 hours as the validation may still happen. Otherwise, please `submit a support
|
|
||||||
ticket <https://www.odoo.com/help>`_ including screenshots of your CNAME records.
|
|
||||||
|
|
||||||
.. _domain-name/ssl:
|
.. _domain-name/ssl:
|
||||||
|
|
||||||
SSL encryption (HTTPS protocol)
|
SSL encryption (HTTPS protocol)
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
**SSL encryption** is an encryption-based Internet security protocol. It allows your visitors to
|
**SSL encryption** allows visitors to navigate a website through a secure connection, which appears
|
||||||
navigate your website through a secure connection, which appears as an ``https://`` protocol at the
|
as the *https://* protocol at the beginning of a web address rather than the non-secure *http://*
|
||||||
beginning of your web address, rather than a non-secure ``http://`` protocol.
|
protocol.
|
||||||
|
|
||||||
Odoo generates a separate SSL certificate for each domain :ref:`mapped in the database manager
|
Odoo generates a separate SSL certificate for each domain :ref:`mapped to a database
|
||||||
<domain-name/db-map>`, using integration with `Let's Encrypt Certificate Authority and ACME protocol
|
<domain-name/db-map>` using `Let's Encrypt's certificate authority and ACME protocol
|
||||||
<https://letsencrypt.org/how-it-works/>`_.
|
<https://letsencrypt.org/how-it-works/>`_.
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
- The certificate generation may take up to 24h.
|
- Certificate generation may take up to 24 hours.
|
||||||
- Several attempts to validate your certificate are made during the five days following the
|
- Several attempts to validate your certificate are made for five days after you map your domain
|
||||||
moment you add your domain name in your database's settings.
|
name to your database.
|
||||||
- If you already use another service, you can keep using it or simply change for Odoo.
|
- If you use another service, you can keep using it or change to Odoo's.
|
||||||
|
|
||||||
|
.. important::
|
||||||
|
No SSL certificate is generated for naked domains :dfn:`(domain names without any subdomains
|
||||||
|
or prefixes)`.
|
||||||
|
|
||||||
.. _domain-name/web-base-url:
|
.. _domain-name/web-base-url:
|
||||||
|
|
||||||
@ -296,71 +258,57 @@ Web base URL of a database
|
|||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
If you have Odoo Website, you can disregard this part and directly :ref:`map your domain name
|
If the Website app is installed on your database, skip this section and continue from the
|
||||||
with your website <domain-name/website-map>`.
|
:ref:`Map a domain name to a website <domain-name/website-map>` section.
|
||||||
|
|
||||||
The **web base URL** of a database, or **root URL** affects your main website address and all the
|
The *web base URL* or root URL of a database affects your main website address and all the
|
||||||
links sent to your customers (e.g., quotations, portal links, etc.).
|
links sent to your customers (e.g., quotations, portal links, etc.).
|
||||||
|
|
||||||
To configure it, access your Odoo database with your custom address, then log in as an administrator
|
To make your custom domain name the *web base URL* of your database, access your database using your
|
||||||
of your database (any user in the *Settings* group) from the login screen.
|
custom domain name and log in as an administrator :dfn:`(a user part of the Settings access right
|
||||||
|
group under Administration)`.
|
||||||
|
|
||||||
.. warning::
|
.. warning::
|
||||||
Connecting to your database with the original Odoo subdomain address (e.g., ``example.odoo.com``
|
If you access your database with the original Odoo address (e.g., `mycompany.odoo.com`), the *web
|
||||||
also updates the web base URL of your database. See below to prevent these automatic updates.
|
base URL* of your database will be updated accordingly. To prevent the automatic update of the
|
||||||
|
*web base URL* when an administrator logs in to the database, activate the :ref:`developer mode
|
||||||
Alternatively, you can do it manually. To do so, activate the :ref:`developer mode
|
<developer-mode>`, go to :menuselection:`Settings --> Technical --> System Parameters --> New`,
|
||||||
<developer-mode>`, then go to :menuselection:`Settings --> Technical --> System Parameters`.
|
and enter `web.base.url.freeze` as the :guilabel:`Key` and `True` as the :guilabel:`Value`.
|
||||||
|
|
||||||
Find the key called ``web.base.url`` (or create it if it does not exist) and enter the full address
|
|
||||||
of your website as value, such as ``https://www.example.com``.
|
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
The URL must include the protocol ``https://`` (or ``http://``) and must not end with a slash
|
You can also set the web base URL manually. To do so, activate the :ref:`developer mode
|
||||||
(``/``).
|
<developer-mode>`, go to :menuselection:`Settings --> Technical --> System Parameters`, and
|
||||||
|
search for the `web.base.url` key (create it if necessary) and enter the full address of your
|
||||||
To prevent the automatic update of the web base URL when an administrator logs in the database, you
|
website as the value (e.g., `https://www.yourdomain.com`). The URL must include the protocol
|
||||||
can create the following System Parameter:
|
`https://` (or `http://`) and *not* end with a slash (`/`).
|
||||||
|
|
||||||
- key: ``web.base.url.freeze``
|
|
||||||
- value: ``True``
|
|
||||||
|
|
||||||
.. _domain-name/website-map:
|
.. _domain-name/website-map:
|
||||||
|
|
||||||
Map your domain name with your website
|
Map a domain name to an Odoo website
|
||||||
======================================
|
------------------------------------
|
||||||
|
|
||||||
Mapping your domain name to your website isn't the same as mapping it with your database:
|
Mapping your domain name to your website is different than mapping it to your database:
|
||||||
|
|
||||||
- It defines your domain name as the main one for your website, helping search engines to index your
|
- It defines your domain name as the main one for your website, helping search engines to index your
|
||||||
website properly.
|
website correctly.
|
||||||
- It defines your domain name as the base URL for your database, including the portal links sent by
|
- It defines your domain name as the base URL for your database, including portal links sent by
|
||||||
email to your customers.
|
email to your customers.
|
||||||
- If you have multiple websites, it maps your domain name with the appropriate website.
|
- If you have multiple websites, it maps your domain name to the appropriate website.
|
||||||
|
|
||||||
Go to :menuselection:`Website --> Configuration --> Settings --> Website Info`. If you have multiple
|
Go to :menuselection:`Website --> Configuration --> Settings`. If you have multiple websites, select
|
||||||
websites, select the one you want to configure.
|
the one you want to configure. In the :guilabel:`Domain` field, enter the address of your website
|
||||||
|
(e.g., `https://www.yourdomain.com`) and :guilabel:`Save`.
|
||||||
In the :guilabel:`Domain` field, fill in the web address of your website (e.g.,
|
|
||||||
``https://www.example.com``) and click on :guilabel:`Save`.
|
|
||||||
|
|
||||||
.. image:: domain_names/website-settings.png
|
|
||||||
:align: center
|
|
||||||
:alt: Configuring https://www.example.com as the Domain of the website
|
|
||||||
|
|
||||||
.. warning::
|
.. warning::
|
||||||
Mapping your domain name with your Odoo website prevents Google from indexing both your custom
|
Mapping your domain name to your Odoo website prevents Google Search from indexing your original
|
||||||
domain name ``www.example.com`` and your original odoo database address ``example.odoo.com``.
|
database address (e.g., `mycompany.odoo.com`).
|
||||||
|
|
||||||
If both addresses are already indexed, it may take some time before Google removes the indexation
|
If both addresses are already indexed, it may take some time before the indexation of the second
|
||||||
of the second address. You may also try using the `Google Search Console
|
address is removed from Google Search. You can use the `Google Search Console
|
||||||
<https://search.google.com/search-console>`_ to fix this.
|
<https://search.google.com/search-console/welcome>`_ to fix the issue.
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
If you have multiple websites and companies on your database, make sure that you select the
|
If you have multiple websites and companies on your database, make sure to select the right
|
||||||
right :guilabel:`Company` in the website settings, next to the :guilabel:`Domain` settings. Doing
|
:guilabel:`Company` under :menuselection:`Website --> Configuration --> Settings`. Doing so
|
||||||
so indicates Odoo which URL to use as the :ref:`base URL <domain-name/web-base-url>` according to
|
indicates Odoo which URL to use as the :ref:`base URL <domain-name/web-base-url>` according to
|
||||||
the company in use.
|
the company in use.
|
||||||
|
|
||||||
.. seealso::
|
|
||||||
- :doc:`/applications/general/email_communication/email_servers`
|
|
||||||
|
|||||||
BIN
content/administration/maintain/domain_names/dns.png
Normal file
BIN
content/administration/maintain/domain_names/dns.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 7.8 KiB |
BIN
content/administration/maintain/domain_names/domain-names.png
Normal file
BIN
content/administration/maintain/domain_names/domain-names.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 5.8 KiB |
BIN
content/administration/maintain/domain_names/domain-owner.png
Normal file
BIN
content/administration/maintain/domain_names/domain-owner.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 10 KiB |
BIN
content/administration/maintain/domain_names/domain-search.png
Normal file
BIN
content/administration/maintain/domain_names/domain-search.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 17 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 12 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 26 KiB |
BIN
content/administration/maintain/domain_names/map-database-sh.png
Normal file
BIN
content/administration/maintain/domain_names/map-database-sh.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 8.9 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 8.9 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 22 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 32 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 7.2 KiB |
@ -72,7 +72,7 @@ Domain names
|
|||||||
Use a custom :doc:`domain name <domain_names>` to access the database via another URL.
|
Use a custom :doc:`domain name <domain_names>` to access the database via another URL.
|
||||||
|
|
||||||
.. tip::
|
.. tip::
|
||||||
You can :ref:`register a domain name for free <domain-name/odoo-register>`.
|
You can :ref:`register a domain name for free <domain-name/register>`.
|
||||||
|
|
||||||
.. _odoo_online/tags:
|
.. _odoo_online/tags:
|
||||||
|
|
||||||
|
|||||||
@ -1,3 +1,5 @@
|
|||||||
|
.. _communication/emails_servers:
|
||||||
|
|
||||||
====================================================
|
====================================================
|
||||||
Send and receive emails in Odoo with an email server
|
Send and receive emails in Odoo with an email server
|
||||||
====================================================
|
====================================================
|
||||||
|
|||||||
@ -11,9 +11,9 @@ Run a modern open-source online store with Odoo eCommerce. Learn how to sell onl
|
|||||||
products and increase your average cart sizes.
|
products and increase your average cart sizes.
|
||||||
|
|
||||||
.. important::
|
.. important::
|
||||||
Odoo offers a :ref:`free custom domain name <domain-name/odoo-register>` to all Odoo Online
|
Odoo offers a :ref:`free custom domain name <domain-name/register>` to all Odoo Online databases
|
||||||
databases for one year. Visitors can then access your website with an address such as
|
for one year. Visitors can then access your website with an address such as `www.example.com`
|
||||||
``www.example.com`` rather than the default ``example.odoo.com``.
|
rather than the default `example.odoo.com`.
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
- :doc:`Website Documentation <website>`
|
- :doc:`Website Documentation <website>`
|
||||||
|
|||||||
@ -11,10 +11,9 @@ Discover the best **Open-Source Website Builder** and learn how to build beautif
|
|||||||
convert visitors into leads or revenues.
|
convert visitors into leads or revenues.
|
||||||
|
|
||||||
.. important::
|
.. important::
|
||||||
Odoo offers a :ref:`free custom domain name <domain-name/odoo-register>` to all Odoo Online
|
Odoo offers a :ref:`free custom domain name <domain-name/register>` to all Odoo Online databases
|
||||||
databases for one year. Visitors can then access your website with an address such as
|
for one year. Visitors can then access your website with an address such as `www.example.com`
|
||||||
``www.example.com`` rather than the default ``example.odoo.com``.
|
rather than the default `example.odoo.com`.
|
||||||
|
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
- `Odoo Tutorials: Website <https://www.odoo.com/slides/website-25>`_
|
- `Odoo Tutorials: Website <https://www.odoo.com/slides/website-25>`_
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user