This guide describes the meaning of TTL, an abbreviation for «Time To Live» as well as the principle of DNS propagation delays, important concepts in the operation of services related to domain names.

Preamble

• The TTL determines how long DNS information is cached before being updated.
• This directly influences the speed of DNS changes propagation across servers worldwide.
• Although reducing the TTL can speed up propagation, the behavior of ISPs and their caches can introduce additional delays.

The TTL (Time to Live)

The TTL (Time to Live) is a key parameter in managing DNS records. It represents the duration, expressed in seconds, during which DNS information can be stored in cache before being updated. When a DNS server or an Internet Service Provider (ISP) queries a DNS zone, it temporarily stores the responses obtained in order to reduce the load on the servers and speed up navigation for users.

For example, if the TTL is set to 24 hours (86400 seconds), the DNS information related to a domain will be cached and will not be updated for the entire duration, even if you have modified parameters such as the domain's IP address. This means that DNS changes will only take effect once this period has elapsed.

It is possible to speed up the application of changes by reducing the TTL before making updates. For example, lowering the TTL to one hour (3600 seconds) allows DNS servers to check new information more quickly after a modification.

DNS propagation

The TTL is directly related to the process of DNS propagation. DNS propagation refers to the time required for changes made to a DNS zone to be distributed across all DNS servers in the world. This delay depends not only on the configured TTL, but also on how ISPs and other DNS servers manage their caches.

When you modify DNS records, DNS servers and ISPs must wait for the TTL delay to expire before retrieving the new information. Thus, the shorter the TTL, the faster the changes propagate through the network. However, some ISPs sometimes ignore the TTL duration and retain the information in cache for a longer period (for example 24 hours or more), which can slow down the propagation of DNS changes, even if you have configured a reduced TTL.

This guide explains how to create and manage your authentication tokens to interact with the Infomaniak API securely.

Preamble

• Token features:
  • Number: no limit on creation
  • Validity: unlimited by default (customizable upon creation)
  • Inactivity: a token is automatically deactivated if it is not used for a year
• Usage example:
  • Token for the Newsletter API

Manage API tokens

When creating, you must define the application and the access scope:

1. Access token management on the Manager (need help?).
2. Click on Create a token:
   
3. Select the product/application and the validity period:
   
4. Confirm the operation with your account password.
5. Important: copy the token and keep it in a safe place; it will no longer be displayed afterwards.

To delete, select them and click on the revocation button that appears:

This guide explains how to link a domain name to the kSuite offer from Infomaniak.

Manage the kSuite domain

To get started:

1. Click here to access the kSuite management interface in the Infomaniak Manager (need help?).
2. If a domain is already linked, you can manage it by clicking on the action menu ⋮ to the right of the kSuite name, then Manage domains:
   
3. If no domain is yet linked, you can add one by clicking on the button:
   
4. Click on the button to add a domain:
   
5. Choose the domain to associate from among those in your Organization (still available, i.e., not yet associated with any service), or enter an external domain name:
   
   • Depending on the status of your domain (also see the information below), you may need to perform some preliminary steps…
     
   • … or even purchase a domain if necessary:
     

If the domain name is located…

… with Infomaniak, same Organization

If your domain name is registered with Infomaniak and is in the same user account or Organization as your email, then there is nothing to do.

Simply add it to your kSuite:

The domain will then be added and visible on the dashboard:

• Refer to this other guide to check and correct any configuration errors.

... with Infomaniak, same Organization and already linked to a Mail Service or kDrive

No problem, you can transform your existing products into a kSuite.

… with Infomaniak, different Organization

If your domain name is registered with Infomaniak but in a different user account or Organisation, then:

• Edit its DNS zone by specifying Infomaniak's MX record (+ SPF & DKIM).
  • Any DNS addition/modification may take up to 48 hours to propagate.

OU

• Move it within the same Organisation.

In general, a message will notify you of this situation:

… and the technical information, which you should enter where the domain is located, will be provided:

… with Infomaniak, using external DNS

If your domain name uses DNS that is not Infomaniak's, then:

• Edit the current DNS zone where it is located (if necessary, consult the help documentation of the provider in question) by specifying Infomaniak's MX record (+ SPF & DKIM).
  • Any DNS addition/modification may take up to 48 hours to propagate.

OU

• Change the current DNS settings and select the option to use Infomaniak's DNS servers.
  • Any DNS addition or modification may take up to 48 hours to propagate.
• Refer to this other guide to check and correct any potential configuration errors.

You will be notified (see the images above).

… elsewhere with external DNS

If your domain name is registered with another registrar and uses DNS servers that are not Infomaniak's, then:

• Edit the current DNS zone where it is located (if necessary, consult the help documentation of the provider in question) and specify Infomaniak's MX record (+ SPF & DKIM).
  • Any DNS addition or modification may take up to 48 hours to propagate.

OU

• Change the current DNS servers (if necessary, consult the help documentation of the provider in question) to Infomaniak's DNS servers (this requires you to have a DNS zone with Infomaniak).
  • Any DNS addition or modification may take up to 48 hours to propagate.
• This DNS zone with Infomaniak will be configured correctly, but refer to this other guide to check and correct any potential configuration errors.

You will be notified (see the images above).

… elsewhere, but you can bring it back

If your domain name is registered with another registrar and you want to move it to the same location as your Infomaniak email, then:

• Transfer the domain name to Infomaniak (it will be configured correctly, but please refer to this other guide to check and correct any potential configuration errors).

Otherwise, consider ordering a new domain name if necessary.

This guide explains how to link multiple domain names to an existing kSuite by adding additional domain names.

Prerequisites

• Own the new domain name (if necessary, create it beforehand).
• Review the information in this other guide and apply the instructions that correspond to your situation (to ensure that the domain name works when it is linked to your kSuite).

Adding a Domain Name to kSuite

Once the new domain name is ready to be used alongside the old one, you need to add it to kSuite:

1. Click here to access the management of your kSuite (need help?).
2. Click on the Settings icon ‍ in the top right corner.
3. Click on kSuite in the left-hand menu.
4. Click on Domains:
   
5. Click the blue Add a domain alias button:
   
6. Choose the domain to link from among those in your Organization (still available, i.e., not linked to any service) or enter an external domain name (see prerequisites).
7. Click the button to add the domain:
   
8. The domain has been successfully linked:
   

This guide explains how to replace the main domain name associated with a kSuite.

Introduction

• Switching the domain linked to kSuite is useful if your business changes its name.
• This affects:
  • Custom Brand (and therefore the custom URLs leading to your tools such as kDrive or Euria)
  • Mail Service (and therefore your email addresses)

Changing the kSuite Domain Name

Prerequisites

• Own the new domain name (if necessary, create it beforehand).
• Review the information in this other guide and apply the instructions that correspond to your situation (to ensure that the domain name works when it is linked to your kSuite).
• Add the domain name to kSuite.

Once the new domain name is ready to be used in place of the old one:

1. Click here to access the management of your kSuite (need help?).
2. Click on the Settings icon ‍ in the top right corner.
3. Click on kSuite in the left-hand menu.
4. Click on Domains:
   
5. Click on the action menu ⋮ located to the right of the domain that is intended to replace the current domain.
6. Click on Set as primary domain:
   
7. Information will be displayed; click the Continue button.
8. Read the information on the screen and confirm that you have read it.
9. Click the Continue button:
   
10. Click the Confirm button:
    

Impact on the Mail Service

By reversing the domain name of the kSuite as described above, the Mail Service within the kSuite is automatically updated. You will go from:

… to this:

This guide explains how to connect a site created with Site Creator Infomaniak to a domain name.

Prerequisites

• The Site Creator Free offer allows access to the site via a domain name in the form 123xyz.infomaniak.site…
  • To connect a custom domain name, you must first upgrade to a higher offer:
    
• The Site Creator Lite and Pro offers include a free domain name for 1 year among the extensions .ch, .com, .fr, .org, .co.uk, .be, .de, .eu, .it, .es
• If you wish to use an existing domain, it must be in the same Organization.

Connect Site Creator to a domain name

To connect Site Creator (Lite or Pro) to a domain name:

1. Click here to access the management of your site on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the site in question.
3. Click on Connect my site to a domain to start the configuration wizard:
   
4. The wizard offers to create a new domain name or use an existing one:
   
   • If you create a new domain name at this time, you will need to return to this configuration wizard once the order is complete.
   • If you choose to attach a domain from those existing in your Organization, the wizard offers a list of domains and a subdomain can be created at this time:
     
5. Click the Next button.
6. Check the selected address and then click the button to Confirm:
   

Manage Site Creator domain name(s)

To manage the domain name(s) used with Site Creator:

1. Click here to access the management of your site on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the site in question.

At the top of the page, any messages regarding issues with Site Creator and domains are displayed.

Further down, you can manage your domains if there are any, click on the chevron ‍ if necessary:

Temporary domain, provisional address, preview URL...

Multiple domain names can be linked to Site Creator, deleted, or swapped and reversed if necessary.

Click on the action menu ⋮ to the right of the domain in question:

However, the preview URL, of type 123xyz.infomaniak.site and distinct in the list of Site Creator domains, cannot be deleted for the proper functioning of your site.

This guide shows you how to configure your UniFi Gateway equipment UniFi to access your services and devices via Infomaniak DynDNS.

Prerequisites

• Have a UniFi Gateway device (e.g., UDM Pro/SE, UDR, UXG, Ultra or USG).
• A dynamic DNS must have been created on the relevant domain via the Infomaniak Manager.

DynDNS Configuration on UniFi Gateway

UniFi devices include a configurable DynDNS client via the UniFi Network interface:

1. Access your UniFi Network controller (via the local IP address or the UniFi cloud portal).
2. Go to Settings (gear icon).
3. In the left menu, select Internet.
4. Click on the relevant WAN interface (usually "WAN" or "Primary").
5. Scroll down to the Dynamic DNS section and click on Create New Dynamic DNS.
6. Fill in the fields with the following information:
   • Service: Select Custom.
   • Server: infomaniak.com
   • Hostname: The full domain name configured (e.g., my-domain.xyz or ddns.my-domain.xyz).
   • Username: The identifier defined in the Infomaniak Manager when creating the DynDNS.
   • Password: The password defined in the Infomaniak Manager.

   • Request URL (Update URL): Copy the URL below exactly (UniFi requires the use of %h for the domain and %i for the IP address):

     https://infomaniak.com/nic/update?hostname=%h&myip=%i

7. Click on Apply Changes (apply changes).

Note: The UniFi device will automatically replace the variables with your actual information when sending the request. Once saved, the status should display "Good" after one to two minutes.

Firewall and port redirection (NAT)

To access a specific service on your local network (NAS, camera, server) from the outside, you must create a redirection rule:

1. In Settings, go to Security > Port Forwarding.
2. Click on Create New Rule.
3. Configure the settings:
   • Name : A clear name (e.g., NAS Access).
   • Forward IP : The local IP address of your device (e.g., 192.168.1.123).
   • Forward Port : The port of the service in question.
   • Protocol : Select the required protocol (often TCP).
4. Save the rule.

This guide explains how to remove the link between a domain name and kSuite Free.

Introduction

• Once removed, the domain name is again available to be linked to one of your services.

Remove the linked domain

To unlink a domain name from kSuite Free:

1. Click here to access the management of your kSuite in the Infomaniak Manager (need help?).
2. Click on the action menu ⋮ to the right of the kSuite name.
3. Select Manage domains:
   
4. Click on the ⋮ icon to the right of the domain name you wish to unlink.
5. Click on “Unlink domain”:
   
   • If you have a paid kSuite plan, you cannot unlink the domain name (cancel the paid plan if necessary):
     
6. If necessary, enable the deletion of the domain name's DNS entries.
7. Confirm the detachment.
8. Click on the button to confirm: