docs: restructure help pages into bundles and add new reference pages
Convert several pages to leaf bundles with WebP screenshots, add api-keys, domain-availability, notifications, provider-features, quotas, services, settings, signup and subdomains pages, and refresh existing content.
|
|
@ -1,10 +1,10 @@
|
|||
baseURL: https://help.happydomain.org/
|
||||
defaultContentLanguage: en
|
||||
defaultContentLanguageInSubdir: true
|
||||
enableGitInfo: true
|
||||
|
||||
theme: hugo-theme-relearn
|
||||
|
||||
|
||||
languages:
|
||||
en:
|
||||
title: "happyDomain help center"
|
||||
|
|
@ -50,6 +50,7 @@ params:
|
|||
# next to it (a single space resolves to an empty logo title).
|
||||
linkTitle: " "
|
||||
showVisitedLinks: true
|
||||
hideAuthorEmail: true
|
||||
mermaid: false
|
||||
# "auto" follows the OS light/dark preference: light -> green, dark ->
|
||||
# relearn-dark. Both must be declared as variants so the theme attaches the
|
||||
|
|
@ -61,7 +62,6 @@ params:
|
|||
- identifier: green
|
||||
- identifier: relearn-dark
|
||||
|
||||
|
||||
# The relearn theme attaches CSS classes to generated blocks (e.g. the
|
||||
# `children` shortcode appends `{class="children ..."}` after its list).
|
||||
# Goldmark only interprets that as block attributes when block parsing is
|
||||
|
|
@ -75,4 +75,4 @@ markup:
|
|||
unsafe: true
|
||||
|
||||
outputs:
|
||||
home: [ "HTML", "RSS", "PRINT"]
|
||||
home: ["HTML", "RSS", "PRINT"]
|
||||
|
|
|
|||
|
|
@ -4,9 +4,6 @@ title: Welcome to happyDomain
|
|||
author: Frederic
|
||||
description: "Finally a simple interface for domain names."
|
||||
archetype: home
|
||||
aliases:
|
||||
en/pages/login
|
||||
en/pages/signup
|
||||
---
|
||||
|
||||
happyDomain is an interface that centralize your domain names and reduces the usual friction points.
|
||||
|
|
|
|||
|
|
@ -4,9 +4,6 @@ title: happyDomain
|
|||
description: "L'interface des noms de domaine."
|
||||
author: nemunaire
|
||||
archetype: home
|
||||
aliases:
|
||||
fr/pages/login
|
||||
fr/pages/signup
|
||||
---
|
||||
|
||||
happyDomain est une interface qui centralise vos noms de domaines et réduit les points de friction habituels.
|
||||
|
|
|
|||
|
|
@ -6,4 +6,30 @@ archetype: chapter
|
|||
weight: 10
|
||||
---
|
||||
|
||||
This section walks through happyDomain feature by feature, following the path a new user
|
||||
takes: from creating an account to publishing a fully managed zone.
|
||||
|
||||
You start by [creating an account]({{% relref "signup" %}}) and [logging in]({{% relref "login" %}}),
|
||||
then land on the [dashboard]({{% relref "domains" %}}) that centralizes all your domains.
|
||||
|
||||
Before importing a domain, you connect a [provider]({{% relref "provider-list" %}}): happyDomain
|
||||
[adds]({{% relref "provider-new-choice" %}}) and [configures]({{% relref "provider-update" %}})
|
||||
it for you, whatever its [specific features]({{% relref "provider-features" %}}).
|
||||
|
||||
You can then [import a domain]({{% relref "domain-new" %}}) and explore it in the
|
||||
[zone editor]({{% relref "domain-abstract" %}}), which
|
||||
lets you manage [subdomains]({{% relref "subdomains" %}}) and group records into
|
||||
[services]({{% relref "services" %}}). Every change is reviewed
|
||||
before you [publish]({{% relref "publish-changes" %}}) it, and the
|
||||
[history]({{% relref "domain-history" %}}) keeps track of everything. You can also
|
||||
[import or export]({{% relref "import-export" %}}) the whole zone as a standard file.
|
||||
|
||||
happyDomain also helps you keep an eye on your domains with
|
||||
[monitoring and checks]({{% relref "checks" %}}), [availability lookups]({{% relref "domain-availability" %}})
|
||||
and the [domain test tool]({{% relref "tools-client" %}}).
|
||||
|
||||
Finally, you can fine-tune your account: [your account and settings]({{% relref "settings" %}}),
|
||||
[sessions and API access]({{% relref "api-keys" %}}),
|
||||
[notifications]({{% relref "notifications" %}}) and [quotas]({{% relref "quotas" %}}).
|
||||
|
||||
{{% children %}}
|
||||
|
|
|
|||
|
|
@ -5,4 +5,34 @@ archetype: chapter
|
|||
weight: 10
|
||||
---
|
||||
|
||||
Cette section présente happyDomain fonctionnalité par fonctionnalité, en suivant le
|
||||
parcours d'un nouvel utilisateur : de la création de son compte jusqu'à la publication
|
||||
d'une zone entièrement gérée.
|
||||
|
||||
Vous commencez par [créer un compte]({{% relref "signup" %}}) et
|
||||
[vous connecter]({{% relref "login" %}}), puis vous arrivez sur le
|
||||
[tableau de bord]({{% relref "domains" %}}) qui centralise tous vos domaines.
|
||||
|
||||
Avant d'importer un domaine, vous raccordez un [hébergeur]({{% relref "provider-list" %}}) :
|
||||
happyDomain l'[ajoute]({{% relref "provider-new-choice" %}}) et le
|
||||
[configure]({{% relref "provider-update" %}}) pour vous, quelles que soient ses
|
||||
[particularités]({{% relref "provider-features" %}}).
|
||||
|
||||
Vous pouvez alors [importer un domaine]({{% relref "domain-new" %}}) et le consulter dans
|
||||
l'[éditeur de zone]({{% relref "domain-abstract" %}}), qui
|
||||
vous permet de gérer les [sous-domaines]({{% relref "subdomains" %}}) et de regrouper les
|
||||
enregistrements en [services]({{% relref "services" %}}). Chaque modification est
|
||||
examinée avant que vous ne la [publiiez]({{% relref "publish-changes" %}}),
|
||||
et l'[historique]({{% relref "domain-history" %}}) garde la trace de tout. Vous pouvez aussi
|
||||
[importer ou exporter]({{% relref "import-export" %}}) la zone entière sous forme de fichier standard.
|
||||
|
||||
happyDomain vous aide également à garder un œil sur vos domaines, grâce à la
|
||||
[surveillance et aux vérifications]({{% relref "checks" %}}), aux
|
||||
[recherches de disponibilité]({{% relref "domain-availability" %}}) et à
|
||||
l'[outil de test de domaine]({{% relref "tools-client" %}}).
|
||||
|
||||
Enfin, vous pouvez peaufiner votre compte : [votre compte et vos réglages]({{% relref "settings" %}}),
|
||||
les [sessions et accès API]({{% relref "api-keys" %}}), les
|
||||
[notifications]({{% relref "notifications" %}}) et les [quotas]({{% relref "quotas" %}}).
|
||||
|
||||
{{% children %}}
|
||||
|
|
|
|||
55
content/pages/api-keys.en.md
Normal file
|
|
@ -0,0 +1,55 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Sessions & API access
|
||||
author: nemunaire
|
||||
weight: 2200
|
||||
description: "Manage your active sessions and use authentication tokens to call the happyDomain REST API"
|
||||
---
|
||||
|
||||
happyDomain does not have a separate "API keys" feature. Instead, every way of accessing the platform, whether through the web interface or the REST API, relies on the same kind of **session token**. Managing your sessions therefore also means managing your API access.
|
||||
|
||||
You manage your sessions from the security section of your account, under **Active Sessions**.
|
||||
|
||||
<!-- TODO: screenshot of the sessions manager -->
|
||||
|
||||
## Listing your active sessions
|
||||
|
||||
The list shows every session currently open on your account. For each one you see:
|
||||
|
||||
- its **description** (the name given when it was created), followed by a short fingerprint derived from the token;
|
||||
- a **current session** badge on the session you are using right now;
|
||||
- when it was **created**, when it was **last used**, and when it **expires**.
|
||||
|
||||
Sessions are sorted with the most recently used first.
|
||||
|
||||
## Creating a token for API access
|
||||
|
||||
To obtain a token you can use to call the API:
|
||||
|
||||
1. Click **Create API key**.
|
||||
2. Give the session a **description** (for example the name of the script or machine that will use it). This helps you recognise it later in the list.
|
||||
3. Validate the creation.
|
||||
|
||||
The token secret is then displayed **once**. Use the eye button to reveal it and the copy button to put it on your clipboard.
|
||||
|
||||
{{% notice style="warning" title="Copy the secret immediately" icon="triangle-exclamation" %}}
|
||||
The session secret is shown only at creation time and is never displayed again. Copy it and store it somewhere safe before closing the dialog. If you lose it, delete the session and create a new one.
|
||||
{{% /notice %}}
|
||||
|
||||
## Using a token with the REST API
|
||||
|
||||
The token is passed in the HTTP `Authorization` header as a Bearer token. For example, to list your domains:
|
||||
|
||||
```sh
|
||||
curl -H "Authorization: Bearer YOUR_SECRET_TOKEN" https://your-happydomain-server/api/domains
|
||||
```
|
||||
|
||||
Replace `YOUR_SECRET_TOKEN` with the secret you copied, and the host with the address of your happyDomain instance. Any API endpoint is reached the same way, by sending this header with each request.
|
||||
|
||||
## Revoking a session
|
||||
|
||||
To revoke a session (and the token associated with it), click the delete button on its row. The token stops working immediately. You cannot delete the session you are currently using from this list; to end it, simply log out, or use the option below.
|
||||
|
||||
{{% notice style="info" title="Terminate all sessions" icon="circle-info" %}}
|
||||
The **Terminate all sessions** button closes every session at once, including the one you are using. This is useful if you suspect a token has leaked: all existing tokens become invalid and you are sent back to the [login page]({{% relref "login" %}}). You will then need to log in again and recreate any API tokens you still need.
|
||||
{{% /notice %}}
|
||||
54
content/pages/api-keys.fr.md
Normal file
|
|
@ -0,0 +1,54 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Sessions et accès à l'API
|
||||
weight: 2200
|
||||
description: "Gérez vos sessions actives et utilisez les jetons d'authentification pour appeler l'API REST de happyDomain"
|
||||
---
|
||||
|
||||
happyDomain ne propose pas de fonctionnalité distincte de « clés d'API ». À la place, toutes les façons d'accéder à la plateforme, que ce soit via l'interface web ou via l'API REST, reposent sur le même type de **jeton de session**. Gérer ses sessions revient donc aussi à gérer ses accès à l'API.
|
||||
|
||||
Vous gérez vos sessions depuis la section sécurité de votre compte, sous « Sessions actives ».
|
||||
|
||||
<!-- TODO: screenshot of the sessions manager -->
|
||||
|
||||
## Lister vos sessions actives
|
||||
|
||||
La liste présente toutes les sessions actuellement ouvertes sur votre compte. Pour chacune, vous voyez :
|
||||
|
||||
- sa **description** (le nom donné lors de sa création), suivie d'une courte empreinte dérivée du jeton ;
|
||||
- un badge « session actuelle » sur la session que vous utilisez en ce moment ;
|
||||
- sa date de **création**, sa date de **dernière utilisation** et sa date d'**expiration**.
|
||||
|
||||
Les sessions sont triées de la plus récemment utilisée à la plus ancienne.
|
||||
|
||||
## Créer un jeton pour accéder à l'API
|
||||
|
||||
Pour obtenir un jeton utilisable pour appeler l'API :
|
||||
|
||||
1. Cliquez sur « Créer une clé d'API ».
|
||||
2. Donnez une **description** à la session (par exemple le nom du script ou de la machine qui l'utilisera). Cela vous aidera à la reconnaître plus tard dans la liste.
|
||||
3. Validez la création.
|
||||
|
||||
Le secret du jeton est alors affiché **une seule fois**. Utilisez le bouton en forme d'œil pour le révéler et le bouton de copie pour le placer dans votre presse-papiers.
|
||||
|
||||
{{% notice style="warning" title="Copiez le secret immédiatement" icon="triangle-exclamation" %}}
|
||||
Le secret de la session n'est affiché qu'au moment de sa création et n'est plus jamais montré ensuite. Copiez-le et conservez-le en lieu sûr avant de fermer la fenêtre. En cas de perte, supprimez la session et créez-en une nouvelle.
|
||||
{{% /notice %}}
|
||||
|
||||
## Utiliser un jeton avec l'API REST
|
||||
|
||||
Le jeton se transmet dans l'en-tête HTTP `Authorization`, en tant que jeton « Bearer ». Par exemple, pour lister vos domaines :
|
||||
|
||||
```sh
|
||||
curl -H "Authorization: Bearer VOTRE_JETON_SECRET" https://votre-serveur-happydomain/api/domains
|
||||
```
|
||||
|
||||
Remplacez `VOTRE_JETON_SECRET` par le secret que vous avez copié, et l'hôte par l'adresse de votre instance happyDomain. On atteint n'importe quel point d'accès de l'API de la même manière, en envoyant cet en-tête à chaque requête.
|
||||
|
||||
## Révoquer une session
|
||||
|
||||
Pour révoquer une session (et le jeton qui lui est associé), cliquez sur le bouton de suppression sur sa ligne. Le jeton cesse aussitôt de fonctionner. Vous ne pouvez pas supprimer depuis cette liste la session que vous utilisez actuellement ; pour y mettre fin, déconnectez-vous simplement, ou utilisez l'option ci-dessous.
|
||||
|
||||
{{% notice style="info" title="Fermer toutes les sessions" icon="circle-info" %}}
|
||||
Le bouton « Fermer toutes les sessions » referme l'ensemble des sessions d'un coup, y compris celle que vous utilisez. C'est utile si vous soupçonnez la fuite d'un jeton : tous les jetons existants deviennent invalides et vous êtes renvoyé vers la [page de connexion]({{% relref "login" %}}). Il vous faudra alors vous reconnecter et recréer les jetons d'API dont vous avez encore besoin.
|
||||
{{% /notice %}}
|
||||
|
|
@ -2,7 +2,7 @@
|
|||
date: 2026-04-05T12:00:00+02:00
|
||||
title: Monitoring & Checks
|
||||
author: nemunaire
|
||||
weight: 35
|
||||
weight: 1700
|
||||
description: "Set up automated health checks to monitor your domains and services"
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -2,7 +2,7 @@
|
|||
date: 2026-04-05T12:00:00+02:00
|
||||
title: Surveillance & Vérifications
|
||||
author: nemunaire
|
||||
weight: 35
|
||||
weight: 1700
|
||||
description: "Mettez en place des vérifications automatiques pour surveiller vos domaines et vos services"
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -1,8 +0,0 @@
|
|||
---
|
||||
date: 2021-01-12T21:38:49+02:00
|
||||
title: Your domain
|
||||
author: Frederic
|
||||
weight: 30
|
||||
---
|
||||
|
||||
Need help to write this Documentation page
|
||||
|
|
@ -1,7 +0,0 @@
|
|||
---
|
||||
date: 2020-12-09T18:12:45+01:00
|
||||
title: Éditer votre zone
|
||||
weight: 30
|
||||
---
|
||||
|
||||
Documentation à faire
|
||||
|
After Width: | Height: | Size: 75 KiB |
|
After Width: | Height: | Size: 8.1 KiB |
|
After Width: | Height: | Size: 42 KiB |
|
After Width: | Height: | Size: 17 KiB |
107
content/pages/domain-abstract/index.en.md
Normal file
|
|
@ -0,0 +1,107 @@
|
|||
---
|
||||
date: 2021-01-12T21:38:49+02:00
|
||||
title: "Using the zone editor"
|
||||
author: Frederic
|
||||
weight: 900
|
||||
description: "View, add, edit and delete records and services in your zone, grouped by subdomain"
|
||||
---
|
||||
|
||||
The zone editor is the main screen for working with a domain. It presents the content of your zone grouped by subdomain, and lets you add, edit and delete the services and records that make up your zone, all without touching your hosting provider until you decide to [publish changes]({{% relref "publish-changes" %}}).
|
||||
|
||||
## The editor layout
|
||||
|
||||
When you open a domain, the screen is split in two parts:
|
||||
|
||||
- On the left, a **sidebar** lists every subdomain of the zone. It also gives access to domain-wide actions (history, audit log, checks, WHOIS, import/export, etc.).
|
||||
- On the right, the **Zone Viewer** displays the content of the zone, one block per subdomain.
|
||||
|
||||

|
||||
|
||||
At the very top of the sidebar you will find the **Add a subdomain** button and a gear menu grouping the other actions. The button used to send your changes to your provider (**Publish my changes**) is also reachable from here; see [this page]({{% relref "publish-changes" %}}) for details.
|
||||
|
||||
{{% notice style="info" title="Nothing is sent automatically" icon="cloud" %}}
|
||||
Every change you make in the editor is kept locally in happyDomain. It is only transmitted to your hosting provider once you explicitly publish it.
|
||||
{{% /notice %}}
|
||||
|
||||
## Browsing the zone
|
||||
|
||||
The zone is organised **by subdomain**. The root of the domain is shown first (displayed with the bare domain name), followed by each subdomain. Intermediate subdomains that hold no service of their own are still shown, marked with a dotted icon, so you can always see the full tree.
|
||||
|
||||
- Click a subdomain heading to **expand or collapse** it and reveal the services it contains.
|
||||
- When a block is collapsed, a badge shows how many services it holds; hover it to get a quick summary.
|
||||
- Use the **sidebar** to jump straight to a subdomain: it mirrors the list and scrolls the viewer to the matching block.
|
||||
|
||||
Aliases pointing to a subdomain are shown next to its heading with a `+ N aliases` badge.
|
||||
|
||||
<!-- TODO: screenshot of a subdomain block expanded, showing its services -->
|
||||
|
||||
## Records and services
|
||||
|
||||
happyDomain does not show you a raw list of DNS records by default. Instead, it groups related records into **services**, higher-level objects that are easier to reason about (a mail server, a website, a delegation, etc.). Each service expands into the actual records it generates.
|
||||
|
||||
If you prefer to work directly with individual records, you can switch the zone view mode in your [account settings]({{% relref "settings" %}}). The editor then offers an **Add a record** button instead of **Add a service**.
|
||||
|
||||
## Adding a subdomain
|
||||
|
||||
1. Click **Add a subdomain** at the top of the sidebar.
|
||||
2. Enter the name of the subdomain to create (relative to your domain).
|
||||
3. happyDomain then proposes to add a first service on that subdomain right away.
|
||||
|
||||
A subdomain only really exists once it carries at least one service, so the two steps are chained together.
|
||||
|
||||

|
||||
|
||||
## Adding a service
|
||||
|
||||
To add a service to an existing subdomain:
|
||||
|
||||
1. Locate the subdomain block (or the domain root) in the viewer.
|
||||
2. Click the **+** button on the subdomain heading, or use the **Add a service** action.
|
||||
3. Pick the service type from the selector. The list adapts to what already exists on that subdomain (for instance, you cannot add two conflicting services).
|
||||
4. Fill in the form for the chosen service, then save.
|
||||
|
||||

|
||||
|
||||
## Inspecting a service
|
||||
|
||||
Click a service to open the **details panel** that slides in from the right. It shows:
|
||||
|
||||
- A description of the service type and any comment you set.
|
||||
- The concrete DNS records the service produces.
|
||||
- The propagation status (when the change was last published).
|
||||
- Any health checks attached to that service (see {{% relref "checks" %}}).
|
||||
|
||||
From this panel you can also adjust the **default TTL** of the service, edit it, or delete it.
|
||||
|
||||

|
||||
|
||||
## Editing a service
|
||||
|
||||
1. Open the service details panel, then click **Edit this service**; or use the pencil button shown on simple services such as aliases.
|
||||
2. happyDomain opens the full editing form for the service.
|
||||
3. Make your changes and save. The viewer refreshes to reflect them.
|
||||
|
||||
## Deleting a service
|
||||
|
||||
1. Open the service details panel.
|
||||
2. Click **Delete this service**.
|
||||
|
||||
The service and all the records it generated are removed from your working copy of the zone.
|
||||
|
||||
{{% notice style="warning" title="Some services cannot be removed" icon="triangle-exclamation" %}}
|
||||
The origin service of a zone (the one carrying the SOA and the authoritative name servers) is essential and cannot be deleted from the editor.
|
||||
{{% /notice %}}
|
||||
|
||||
For aliases (CNAME) and reverse pointers (PTR), a dedicated delete button is available directly on the subdomain heading.
|
||||
|
||||
## Aliases
|
||||
|
||||
When a subdomain holds services, you can attach an **alias** to it using the link button on its heading. The alias makes another name resolve to this subdomain.
|
||||
|
||||
## Next steps
|
||||
|
||||
None of the above changes anything at your hosting provider yet. When you are happy with your edits:
|
||||
|
||||
- Review what will change, then send the changes; see {{% relref "publish-changes" %}}.
|
||||
|
||||
You can also re-import the live zone, or import/export it as a standard zone file: see {{% relref "import-export" %}}.
|
||||
106
content/pages/domain-abstract/index.fr.md
Normal file
|
|
@ -0,0 +1,106 @@
|
|||
---
|
||||
date: 2020-12-09T18:12:45+01:00
|
||||
title: "Utiliser l'éditeur de zone"
|
||||
weight: 900
|
||||
description: "Visualiser, ajouter, modifier et supprimer les enregistrements et services de votre zone, regroupés par sous-domaine"
|
||||
---
|
||||
|
||||
L'éditeur de zone est l'écran principal pour travailler sur un domaine. Il présente le contenu de votre zone regroupé par sous-domaine, et vous permet d'ajouter, modifier et supprimer les services et enregistrements qui composent votre zone, sans rien changer chez votre hébergeur tant que vous n'avez pas décidé de [publier vos changements]({{% relref "publish-changes" %}}).
|
||||
|
||||
## Disposition de l'éditeur
|
||||
|
||||
Lorsque vous ouvrez un domaine, l'écran est divisé en deux parties :
|
||||
|
||||
- À gauche, une **barre latérale** liste tous les sous-domaines de la zone. Elle donne aussi accès aux actions concernant l'ensemble du domaine (historique, journal d'audit, contrôles, WHOIS, import/export, etc.).
|
||||
- À droite, le **Visualiseur de zone** affiche le contenu de la zone, un bloc par sous-domaine.
|
||||
|
||||

|
||||
|
||||
Tout en haut de la barre latérale se trouvent le bouton **Ajouter un sous-domaine** et un menu en forme d'engrenage regroupant les autres actions. Le bouton servant à transmettre vos changements à votre hébergeur (« Diffuser mes changements ») est également accessible depuis cet écran ; voyez [cette page]({{% relref "publish-changes" %}}) pour les détails.
|
||||
|
||||
{{% notice style="info" title="Rien n'est envoyé automatiquement" icon="cloud" %}}
|
||||
Chaque modification que vous faites dans l'éditeur est conservée localement dans happyDomain. Elle n'est transmise à votre hébergeur que lorsque vous la publiez explicitement.
|
||||
{{% /notice %}}
|
||||
|
||||
## Parcourir la zone
|
||||
|
||||
La zone est organisée **par sous-domaine**. La racine du domaine apparaît en premier (affichée avec le nom de domaine seul), suivie de chaque sous-domaine. Les sous-domaines intermédiaires qui ne portent aucun service sont tout de même affichés, signalés par une icône en pointillés, afin que vous puissiez toujours voir l'arborescence complète.
|
||||
|
||||
- Cliquez sur le titre d'un sous-domaine pour le **déplier ou le replier** et révéler les services qu'il contient.
|
||||
- Lorsqu'un bloc est replié, un badge indique combien de services il contient ; survolez-le pour obtenir un aperçu rapide.
|
||||
- Utilisez la **barre latérale** pour accéder directement à un sous-domaine : elle reflète la liste et fait défiler le visualiseur jusqu'au bloc correspondant.
|
||||
|
||||
Les alias pointant vers un sous-domaine apparaissent à côté de son titre, sous forme d'un badge « + N alias ».
|
||||
|
||||
<!-- TODO: screenshot d'un bloc de sous-domaine déplié, montrant ses services -->
|
||||
|
||||
## Enregistrements et services
|
||||
|
||||
Par défaut, happyDomain ne vous présente pas une liste brute d'enregistrements DNS. Il regroupe au contraire les enregistrements liés en **services**, des objets de plus haut niveau plus simples à appréhender (un serveur de courrier, un site web, une délégation, etc.). Chaque service se déploie en montrant les enregistrements concrets qu'il génère.
|
||||
|
||||
Si vous préférez travailler directement avec les enregistrements individuels, vous pouvez changer le mode d'affichage de la zone dans [vos préférences]({{% relref "settings" %}}). L'éditeur propose alors un bouton **Ajouter un enregistrement** au lieu d'**Ajouter un service**.
|
||||
|
||||
## Ajouter un sous-domaine
|
||||
|
||||
1. Cliquez sur **Ajouter un sous-domaine** en haut de la barre latérale.
|
||||
2. Saisissez le nom du sous-domaine à créer (relatif à votre domaine).
|
||||
3. happyDomain vous propose ensuite d'ajouter immédiatement un premier service sur ce sous-domaine.
|
||||
|
||||
Un sous-domaine n'existe réellement qu'à partir du moment où il porte au moins un service : les deux étapes sont donc enchaînées.
|
||||
|
||||

|
||||
|
||||
## Ajouter un service
|
||||
|
||||
Pour ajouter un service à un sous-domaine existant :
|
||||
|
||||
1. Repérez le bloc du sous-domaine (ou la racine du domaine) dans le visualiseur.
|
||||
2. Cliquez sur le bouton **+** présent sur le titre du sous-domaine, ou utilisez l'action **Ajouter un service**.
|
||||
3. Choisissez le type de service dans le sélecteur. La liste s'adapte à ce qui existe déjà sur ce sous-domaine (par exemple, vous ne pouvez pas ajouter deux services en conflit).
|
||||
4. Remplissez le formulaire du service choisi, puis enregistrez.
|
||||
|
||||

|
||||
|
||||
## Inspecter un service
|
||||
|
||||
Cliquez sur un service pour ouvrir le **panneau de détails** qui apparaît par la droite. Il présente :
|
||||
|
||||
- Une description du type de service et le commentaire éventuel que vous avez défini.
|
||||
- Les enregistrements DNS concrets que le service produit.
|
||||
- L'état de propagation (date de la dernière publication de la modification).
|
||||
- Les contrôles de santé éventuellement rattachés à ce service (voyez {{% relref "checks" %}}).
|
||||
|
||||
Depuis ce panneau, vous pouvez aussi ajuster le **TTL par défaut** du service, le modifier ou le supprimer.
|
||||
|
||||

|
||||
|
||||
## Modifier un service
|
||||
|
||||
1. Ouvrez le panneau de détails du service, puis cliquez sur **Modifier ce service** ; ou utilisez le bouton crayon affiché sur les services simples comme les alias.
|
||||
2. happyDomain ouvre le formulaire d'édition complet du service.
|
||||
3. Effectuez vos changements et enregistrez. Le visualiseur se met à jour pour les refléter.
|
||||
|
||||
## Supprimer un service
|
||||
|
||||
1. Ouvrez le panneau de détails du service.
|
||||
2. Cliquez sur **Supprimer ce service**.
|
||||
|
||||
Le service et tous les enregistrements qu'il générait sont retirés de votre copie de travail de la zone.
|
||||
|
||||
{{% notice style="warning" title="Certains services ne peuvent pas être supprimés" icon="triangle-exclamation" %}}
|
||||
Le service d'origine d'une zone (celui qui porte le SOA et les serveurs de noms faisant autorité) est essentiel et ne peut pas être supprimé depuis l'éditeur.
|
||||
{{% /notice %}}
|
||||
|
||||
Pour les alias (CNAME) et les pointeurs inverses (PTR), un bouton de suppression dédié est disponible directement sur le titre du sous-domaine.
|
||||
|
||||
## Alias
|
||||
|
||||
Lorsqu'un sous-domaine porte des services, vous pouvez lui rattacher un **alias** à l'aide du bouton en forme de lien présent sur son titre. L'alias fait pointer un autre nom vers ce sous-domaine.
|
||||
|
||||
## Et ensuite
|
||||
|
||||
Aucune des opérations ci-dessus ne change quoi que ce soit chez votre hébergeur pour l'instant. Lorsque vos modifications vous conviennent :
|
||||
|
||||
- Examinez ce qui va changer, puis envoyez les changements ; voyez {{% relref "publish-changes" %}}.
|
||||
|
||||
Vous pouvez aussi réimporter la zone en ligne, ou [l'importer / l'exporter sous forme de fichier de zone standard]({{% relref "import-export" %}}).
|
||||
87
content/pages/domain-availability.en.md
Normal file
|
|
@ -0,0 +1,87 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Domain availability & lookups
|
||||
author: nemunaire
|
||||
weight: 1800
|
||||
description: "Check whether a domain is available for registration, and inspect any domain with the WHOIS and DNS resolver tools"
|
||||
---
|
||||
|
||||
happyDomain bundles a few diagnostic tools that work on any domain name, whether or not you manage it in happyDomain. They let you check if a name is available for registration, look up its registration details (WHOIS), and query its DNS records directly (resolver).
|
||||
|
||||
## Availability checker
|
||||
|
||||
The **Availability** page lets you keep an eye on one or more domain names you would like to register, and be told as soon as one becomes available.
|
||||
|
||||
<!-- TODO: screenshot of the availability page -->
|
||||
|
||||
### Watching a domain
|
||||
|
||||
To start watching a name:
|
||||
|
||||
1. Type the domain you are interested in (for example `mydomain.example`) in the input at the top of the page.
|
||||
2. Click **Add**.
|
||||
|
||||
The name is added to your watch list and an immediate check is launched in the background, so you do not have to wait for the next automatic check to see its current state.
|
||||
|
||||
### Reading the status
|
||||
|
||||
Each watched domain shows a badge reflecting the result of the last check:
|
||||
|
||||
| Badge | Meaning |
|
||||
|-------|---------|
|
||||
| **Available** | The name appears to be free and can probably be registered. |
|
||||
| **Registered** | The name is already taken. |
|
||||
| _(error message)_ | The check could not be completed (for example the extension is unsupported, or the registry could not be reached). |
|
||||
| **Never checked** | No result is available yet. |
|
||||
|
||||
The time of the last check is displayed next to the status.
|
||||
|
||||
### Rechecking and removing
|
||||
|
||||
- Click **Check now** next to a domain to trigger a fresh check immediately. A spinner is shown while the check runs in the background, and the status updates automatically once it finishes.
|
||||
- Click the trash icon to stop watching a domain. A confirmation is asked before removal.
|
||||
|
||||
{{% notice style="tip" title="Availability is a best effort" icon="lightbulb" %}}
|
||||
The availability result is only an indication. Some extensions cannot be checked reliably, and a name that appears free may still be reserved or blocked at registration time. Always confirm with a registrar before counting on a name.
|
||||
{{% /notice %}}
|
||||
|
||||
|
||||
## WHOIS lookup
|
||||
|
||||
The **WHOIS** tool shows the public registration information of a domain: its registrar, important dates and current status.
|
||||
|
||||
<!-- TODO: screenshot of the WHOIS lookup page -->
|
||||
|
||||
Enter a domain name and run the lookup. happyDomain then displays a clear summary of the collected information:
|
||||
|
||||
- **Status**: the registration statuses returned for the domain (for example `active`, `clientTransferProhibited`, a `hold` state, etc.), shown as colour-coded badges.
|
||||
- **Creation date** and **Expiration date**: when the domain was first registered and when its registration is due to expire. The expiration is accompanied by a progress bar and a countdown, which turns orange then red as the date approaches.
|
||||
- **Registrar**: the company through which the domain is registered, with a link to its website when available.
|
||||
- **Nameservers**: the authoritative nameservers declared for the domain.
|
||||
|
||||
If the name is not registered, a message tells you the domain was not found. If the lookup itself fails, the error is shown.
|
||||
|
||||
{{% notice style="info" title="WHOIS and the availability checker" icon="circle-info" %}}
|
||||
The availability checker relies on the same underlying registration data as the WHOIS lookup. If you want the full registration picture for a name, use the WHOIS tool; if you simply want to know whether a name is free (and be notified later), add it to your availability watch list.
|
||||
{{% /notice %}}
|
||||
|
||||
|
||||
## DNS resolver
|
||||
|
||||
The **DNS resolver** lets you query the live DNS of any domain, exactly as it is published on the Internet right now. This is handy to confirm that a change has propagated, or to inspect a domain you do not manage.
|
||||
|
||||
<!-- TODO: screenshot of the resolver page -->
|
||||
|
||||
Enter a domain name and run the query. By default, every record type is requested (`ANY`). Open the **Advanced** options to refine the query:
|
||||
|
||||
- **Field (record type)**: restrict the query to a single record type (`A`, `AAAA`, `MX`, `TXT`, etc.).
|
||||
- **Resolver**: choose which DNS resolver to send the query to. Several well-known public resolvers are offered, and you can pick **Custom** to enter the address of any resolver you want to test against.
|
||||
- **Show DNSSEC records**: include the DNSSEC-related records (`RRSIG`, `NSEC`, `NSEC3`) in the results, which are hidden by default.
|
||||
|
||||
If you manage domains in happyDomain, their names are suggested as you type the domain to query.
|
||||
|
||||
Results are grouped by record type, and each entry shows its fields together with its TTL. When the domain exists but has no record of the requested type, a message says so explicitly.
|
||||
|
||||
{{% notice style="tip" title="Resolver vs. your zone in happyDomain" icon="lightbulb" %}}
|
||||
The resolver shows what is **currently published** by the authoritative servers, which may differ from a draft zone you are editing in happyDomain until you [publish your changes]({{% relref "publish-changes" %}}).
|
||||
{{% /notice %}}
|
||||
86
content/pages/domain-availability.fr.md
Normal file
|
|
@ -0,0 +1,86 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Disponibilité et recherches de domaines
|
||||
weight: 1800
|
||||
description: "Vérifier si un domaine est disponible à l'enregistrement, et inspecter n'importe quel domaine grâce aux outils WHOIS et résolveur DNS"
|
||||
---
|
||||
|
||||
happyDomain embarque quelques outils de diagnostic qui fonctionnent sur n'importe quel nom de domaine, qu'il soit ou non géré dans happyDomain. Ils permettent de vérifier si un nom est disponible à l'enregistrement, de consulter ses informations d'enregistrement (WHOIS), et d'interroger directement ses enregistrements DNS (résolveur).
|
||||
|
||||
## Vérificateur de disponibilité
|
||||
|
||||
La page **Disponibilité** vous permet de surveiller un ou plusieurs noms de domaine que vous souhaiteriez enregistrer, et d'être prévenu dès que l'un d'eux devient disponible.
|
||||
|
||||
<!-- TODO: screenshot of the availability page -->
|
||||
|
||||
### Surveiller un domaine
|
||||
|
||||
Pour commencer à surveiller un nom :
|
||||
|
||||
1. Saisissez le domaine qui vous intéresse (par exemple `mondomaine.example`) dans le champ situé en haut de la page.
|
||||
2. Cliquez sur **Ajouter**.
|
||||
|
||||
Le nom est ajouté à votre liste de surveillance et une première vérification est lancée immédiatement en arrière-plan, afin de ne pas avoir à attendre la prochaine vérification automatique pour connaître son état actuel.
|
||||
|
||||
### Lire le statut
|
||||
|
||||
Chaque domaine surveillé affiche un badge qui reflète le résultat de la dernière vérification :
|
||||
|
||||
| Badge | Signification |
|
||||
|-------|---------------|
|
||||
| **Disponible** | Le nom semble libre et peut probablement être enregistré. |
|
||||
| **Enregistré** | Le nom est déjà pris. |
|
||||
| _(message d'erreur)_ | La vérification n'a pas pu aboutir (par exemple l'extension n'est pas prise en charge, ou le registre n'a pas pu être contacté). |
|
||||
| **Jamais vérifié** | Aucun résultat n'est encore disponible. |
|
||||
|
||||
La date de la dernière vérification est indiquée à côté du statut.
|
||||
|
||||
### Revérifier et supprimer
|
||||
|
||||
- Cliquez sur **Vérifier maintenant** à côté d'un domaine pour déclencher immédiatement une nouvelle vérification. Une animation est affichée pendant que le contrôle s'exécute en arrière-plan, et le statut se met à jour automatiquement une fois terminé.
|
||||
- Cliquez sur l'icône de corbeille pour cesser de surveiller un domaine. Une confirmation est demandée avant la suppression.
|
||||
|
||||
{{% notice style="tip" title="La disponibilité reste indicative" icon="lightbulb" %}}
|
||||
Le résultat de disponibilité n'est qu'une indication. Certaines extensions ne peuvent pas être vérifiées de manière fiable, et un nom qui semble libre peut tout de même être réservé ou bloqué au moment de l'enregistrement. Confirmez toujours auprès d'un bureau d'enregistrement avant de compter sur un nom.
|
||||
{{% /notice %}}
|
||||
|
||||
|
||||
## Recherche WHOIS
|
||||
|
||||
L'outil **WHOIS** affiche les informations publiques d'enregistrement d'un domaine : son bureau d'enregistrement, ses dates importantes et son statut actuel.
|
||||
|
||||
<!-- TODO: screenshot of the WHOIS lookup page -->
|
||||
|
||||
Saisissez un nom de domaine puis lancez la recherche. happyDomain affiche alors un résumé clair des informations collectées :
|
||||
|
||||
- **Statut** : les statuts d'enregistrement renvoyés pour le domaine (par exemple `active`, `clientTransferProhibited`, un état `hold`, etc.), présentés sous forme de badges colorés.
|
||||
- **Date de création** et **Date d'expiration** : la date du premier enregistrement du domaine et celle à laquelle son enregistrement doit expirer. L'expiration est accompagnée d'une barre de progression et d'un compte à rebours, qui passe à l'orange puis au rouge à l'approche de l'échéance.
|
||||
- **Bureau d'enregistrement** : l'organisme auprès duquel le domaine est enregistré, avec un lien vers son site lorsqu'il est disponible.
|
||||
- **Serveurs de noms** : les serveurs de noms faisant autorité déclarés pour le domaine.
|
||||
|
||||
Si le nom n'est pas enregistré, un message vous indique que le domaine est introuvable. Si la recherche elle-même échoue, l'erreur est affichée.
|
||||
|
||||
{{% notice style="info" title="WHOIS et vérificateur de disponibilité" icon="circle-info" %}}
|
||||
Le vérificateur de disponibilité s'appuie sur les mêmes données d'enregistrement que la recherche WHOIS. Si vous souhaitez la vue complète de l'enregistrement d'un nom, utilisez l'outil WHOIS ; si vous voulez simplement savoir si un nom est libre (et être prévenu ultérieurement), ajoutez-le à votre liste de surveillance de disponibilité.
|
||||
{{% /notice %}}
|
||||
|
||||
|
||||
## Résolveur DNS
|
||||
|
||||
Le **résolveur DNS** vous permet d'interroger le DNS en direct de n'importe quel domaine, exactement tel qu'il est publié sur Internet en cet instant. C'est pratique pour confirmer qu'une modification s'est bien propagée, ou pour inspecter un domaine que vous ne gérez pas.
|
||||
|
||||
<!-- TODO: screenshot of the resolver page -->
|
||||
|
||||
Saisissez un nom de domaine puis lancez la requête. Par défaut, tous les types d'enregistrement sont demandés (`ANY`). Ouvrez les options **Avancées** pour affiner la requête :
|
||||
|
||||
- **Champ (type d'enregistrement)** : restreignez la requête à un seul type d'enregistrement (`A`, `AAAA`, `MX`, `TXT`, etc.).
|
||||
- **Résolveur** : choisissez le résolveur DNS auquel envoyer la requête. Plusieurs résolveurs publics réputés sont proposés, et vous pouvez sélectionner **Personnalisé** pour saisir l'adresse du résolveur de votre choix.
|
||||
- **Afficher les enregistrements DNSSEC** : inclure les enregistrements liés à DNSSEC (`RRSIG`, `NSEC`, `NSEC3`) dans les résultats, masqués par défaut.
|
||||
|
||||
Si vous gérez des domaines dans happyDomain, leurs noms vous sont suggérés au fur et à mesure que vous saisissez le domaine à interroger.
|
||||
|
||||
Les résultats sont regroupés par type d'enregistrement, et chaque entrée affiche ses champs ainsi que son TTL. Lorsque le domaine existe mais ne possède aucun enregistrement du type demandé, un message l'indique explicitement.
|
||||
|
||||
{{% notice style="tip" title="Résolveur et votre zone dans happyDomain" icon="lightbulb" %}}
|
||||
Le résolveur montre ce qui est **actuellement publié** par les serveurs faisant autorité, ce qui peut différer d'une zone en cours d'édition dans happyDomain tant que vous n'avez pas [publié vos modifications]({{% relref "publish-changes" %}}).
|
||||
{{% /notice %}}
|
||||
|
|
@ -1,7 +1,43 @@
|
|||
---
|
||||
date: 2025-06-15T11:06:00+02:00
|
||||
title: "View change history"
|
||||
weight: 40
|
||||
weight: 1500
|
||||
---
|
||||
|
||||
Every time you [publish changes]({{% relref "publish-changes" %}}) with happyDomain, they are recorded in a log. This log allows you to easily retrieve the status of your domains as they were previously deployed, and to see when you made each change.
|
||||
|
||||
## Opening the history
|
||||
|
||||
From your domain's page, open the **History** entry in the menu. happyDomain displays every recorded version of the zone, from the most recent at the top to the oldest at the bottom.
|
||||
|
||||
<!-- TODO: screenshot of the history page -->
|
||||
|
||||
To keep the list readable, versions are grouped by month. A heading marks the beginning of each month so you can quickly locate a change by its time period.
|
||||
|
||||
## Reading a version
|
||||
|
||||
Each version is identified by the moment it was last modified, along with the avatar and email address of the author who made the change.
|
||||
|
||||
Three dates may be shown for a version:
|
||||
|
||||
- **Published on**: when this version was deployed to your DNS provider. A version without this date was saved but never published.
|
||||
- **Committed on**: when the version was committed (saved as a definitive state of the zone).
|
||||
- **Modified on**: when the version was last edited.
|
||||
|
||||
If a message was attached when the changes were published, it appears below the dates, much like a commit message in version control.
|
||||
|
||||
## Viewing the zone at a given time
|
||||
|
||||
To inspect the full content of the zone as it was for a given version, click the eye button next to its date. happyDomain opens that version in read-only mode, so you can browse all the records exactly as they were at that moment.
|
||||
|
||||
## Comparing two versions
|
||||
|
||||
Under each version (except the oldest one), the **View differences** section lets you compare it with the version that immediately precedes it.
|
||||
|
||||
<!-- TODO: screenshot of the differences accordion expanded -->
|
||||
|
||||
Expand the section to reveal the changes: added records, deleted records, and modified records are highlighted, so you can see at a glance what each publication changed. The most recent comparison is expanded automatically when you open the page.
|
||||
|
||||
{{% notice style="info" title="No history yet?" %}}
|
||||
A domain only builds up a history once you start publishing changes to it. If you have just imported a domain, its history will fill in as you make and publish your first modifications.
|
||||
{{% /notice %}}
|
||||
|
|
|
|||
|
|
@ -1,7 +1,43 @@
|
|||
---
|
||||
date: 2025-06-15T11:06:00+02:00
|
||||
title: "Voir l'historique des changements"
|
||||
weight: 40
|
||||
weight: 1500
|
||||
---
|
||||
|
||||
À chaque fois que vous [publiez des modifications]({{% relref "publish-changes" %}}) avec happyDomain, celles-ci sont enregistrées dans un journal. Ce journal vous permet de retrouver facilement l'état de vos domaines tels qu'ils étaient déployés précédemment, et de voir quand vous avez fait chaque modification.
|
||||
|
||||
## Ouvrir l'historique
|
||||
|
||||
Depuis la page de votre domaine, ouvrez l'entrée **Historique** dans le menu. happyDomain affiche toutes les versions enregistrées de la zone, de la plus récente en haut à la plus ancienne en bas.
|
||||
|
||||
<!-- TODO: capture d'écran de la page d'historique -->
|
||||
|
||||
Pour garder la liste lisible, les versions sont regroupées par mois. Un en-tête marque le début de chaque mois, ce qui vous permet de retrouver rapidement une modification d'après sa période.
|
||||
|
||||
## Lire une version
|
||||
|
||||
Chaque version est identifiée par le moment de sa dernière modification, accompagné de l'avatar et de l'adresse électronique de l'auteur qui l'a effectuée.
|
||||
|
||||
Trois dates peuvent être affichées pour une version :
|
||||
|
||||
- **Publiée le** : le moment où cette version a été déployée chez votre fournisseur DNS. Une version sans cette date a été enregistrée, mais jamais publiée.
|
||||
- **Enregistrée le** : le moment où la version a été figée (sauvegardée comme un état définitif de la zone).
|
||||
- **Dernière modification le** : le moment où la version a été modifiée pour la dernière fois.
|
||||
|
||||
Si un message a été associé lors de la publication des changements, il apparaît sous les dates, à la manière d'un message de commit dans un gestionnaire de versions.
|
||||
|
||||
## Voir la zone à un instant donné
|
||||
|
||||
Pour examiner le contenu complet de la zone tel qu'il était pour une version donnée, cliquez sur le bouton en forme d'œil situé à côté de sa date. happyDomain ouvre cette version en lecture seule, ce qui vous permet de parcourir tous les enregistrements exactement tels qu'ils étaient à ce moment.
|
||||
|
||||
## Comparer deux versions
|
||||
|
||||
Sous chaque version (sauf la plus ancienne), la section **Voir les changements** vous permet de la comparer avec la version qui la précède immédiatement.
|
||||
|
||||
<!-- TODO: capture d'écran de la section des changements dépliée -->
|
||||
|
||||
Dépliez la section pour révéler les modifications : les enregistrements ajoutés, supprimés et modifiés sont mis en évidence, ce qui vous permet de voir d'un coup d'œil ce que chaque publication a changé. La comparaison la plus récente est dépliée automatiquement à l'ouverture de la page.
|
||||
|
||||
{{% notice style="info" title="Pas encore d'historique ?" %}}
|
||||
Un domaine ne se constitue un historique qu'à partir du moment où vous commencez à y publier des changements. Si vous venez d'importer un domaine, son historique se remplira au fur et à mesure que vous effectuerez et publierez vos premières modifications.
|
||||
{{% /notice %}}
|
||||
|
|
|
|||
|
|
@ -2,7 +2,7 @@
|
|||
date: 2021-01-12T21:38:49+02:00
|
||||
title: Import a domain
|
||||
author: Frederic
|
||||
weight: 20
|
||||
weight: 800
|
||||
---
|
||||
|
||||
Importing a domain into happyDomain does not make happyDomain the owner of your domain. This action does not involve any changes to your usual hosting provider. happyDomain will contact your hosting provider or server to check which services are currently registered.
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
---
|
||||
date: 2020-12-09T18:12:45+01:00
|
||||
title: Importer un domaine
|
||||
weight: 20
|
||||
weight: 800
|
||||
---
|
||||
|
||||
Importer un domaine dans happyDomain ne rend pas happyDomain propriétaire de votre domaine. Cette action n'implique aucune modification auprès de votre hébergeur habituel. happyDomain va communiquer avec votre hébergeur ou votre serveur afin de consulter les services qui sont actuellement enregistrés.
|
||||
|
|
|
|||
|
|
@ -4,14 +4,17 @@ title: Centralize your domains
|
|||
author: Frederic
|
||||
aliases:
|
||||
home
|
||||
weight: 10
|
||||
weight: 300
|
||||
---
|
||||
|
||||
happyDomain provides you with a unified graphical interface with modern features, regardless of where your domain names are hosted. They can be on a DNS server (PowerDNS, bind, knot, ...) of your own, or with one or several providers (around 50 are currently supported).
|
||||
|
||||
|
||||
## Your domains
|
||||
|
||||
The home page presents the list of all the domains managed by happyDomain, whatever their host:
|
||||
|
||||

|
||||

|
||||
|
||||
Click one of the domains to start [make changes]({{% relref "domain-abstract" %}}) (add a sub-domain, add a service, ...).
|
||||
|
||||
|
|
@ -20,7 +23,7 @@ Click one of the domains to start [make changes]({{% relref "domain-abstract" %}
|
|||
|
||||
On the right, you can see the list of the different hosting providers for your:
|
||||
|
||||
The hosters of your domains](hosters-list.png)
|
||||

|
||||
|
||||
You can [add new host]({{% relref "provider-new-choice" %}}) by clicking on the + button in the table header.
|
||||
|
||||
|
|
@ -28,7 +31,7 @@ Clicking on a row in this table will filter the list of domains to show only dom
|
|||
|
||||
You will also see, if the host allows you to list the domains that belong to you, the domains that you can add to happyDomain:
|
||||
|
||||

|
||||

|
||||
|
||||
To view the entire list again, simply click on the selected host again.
|
||||
|
||||
|
|
@ -37,19 +40,19 @@ To view the entire list again, simply click on the selected host again.
|
|||
|
||||
If you find an error or no longer need a hosting provider, click on the ... on the line of the host concerned. You will then be able to choose between [update information]({{% relref "provider-update" %}}) or delete the host:
|
||||
|
||||

|
||||

|
||||
|
||||
Note that you will not be able to remove the host as long as domains referring to it exist in the list on the left.
|
||||
|
||||
|
||||
## Add a domain
|
||||
|
||||
You have a new domain you want to manage in happyDomain? Start by entering its name in the field below the list. You will then be guided to the [to choose the host] screen ({{% relref "domain-new" %}}).
|
||||
You have a new domain you want to manage in happyDomain? Start by entering its name in the field above the list. You will then be guided to the screen [to choose the host]({{% relref "domain-new" %}}).
|
||||
|
||||

|
||||

|
||||
|
||||
The field does not show when a host is selected on the right. Unless this host does not allow to list:
|
||||
Some DNS providers allows you to create a domain directly in their database, even if it was not already registered. First, you'll need to select the right provider. You'll see a dedicated "Create on" button.
|
||||
|
||||

|
||||

|
||||
|
||||
In this case, validating the field will automatically search for the new domain with the selected host, as indicated by the message just above the field.
|
||||
Some providers could charge you for this action, so pay attention if this implies to realy buy the domain.
|
||||
|
|
|
|||
|
|
@ -3,7 +3,7 @@ date: 2020-12-09T18:12:45+01:00
|
|||
title: Regrouper vos domaines
|
||||
aliases:
|
||||
home
|
||||
weight: 10
|
||||
weight: 300
|
||||
---
|
||||
|
||||
happyDomain vous apporte une interface graphique unifiée et avec des fonctionnalités modernes quelque soit l'endroit où sont hébergés vos noms de domaine. Ils peuvent être sur un serveur DNS (PowerDNS, bind, knot, ...) qui vous est propre, ou bien chez un ou plusieurs hébergeurs (une 50aine sont supportés à l'heure actuelle).
|
||||
|
|
@ -13,7 +13,7 @@ happyDomain vous apporte une interface graphique unifiée et avec des fonctionna
|
|||
|
||||
La page d'accueil présente la liste de l'ensemble des domaines gérés par happyDomain, quelque soit leur hébergeur :
|
||||
|
||||

|
||||

|
||||
|
||||
Cliquez sur l'un des domaines pour commencer à [y apporter des modifications]({{% relref "domain-abstract" %}}) (ajouter un sous-domaine, ajouter un service, ...).
|
||||
|
||||
|
|
@ -22,7 +22,7 @@ Cliquez sur l'un des domaines pour commencer à [y apporter des modifications]({
|
|||
|
||||
Sur la droite, vous voyez la liste des différents hébergeurs de vos domaines :
|
||||
|
||||

|
||||

|
||||
|
||||
Vous pouvez [ajouter un nouvel hébergeur]({{% relref "provider-new-choice" %}}) en cliquant sur le bouton +, présent dans l'en-tête du tableau.
|
||||
|
||||
|
|
@ -30,7 +30,7 @@ En cliquant sur une ligne de ce tableau, vous filtrerez la liste des domaines po
|
|||
|
||||
Vous verrez aussi, si l'hébergeur permet de lister les domaines qui vous appartiennent, les domaines que vous pouvez ajouter à happyDomain :
|
||||
|
||||

|
||||

|
||||
|
||||
Pour afficher à nouveau la liste dans son intégralité, recliquez simplement sur l'hébergeur qui est sélectionné.
|
||||
|
||||
|
|
@ -39,7 +39,7 @@ Pour afficher à nouveau la liste dans son intégralité, recliquez simplement s
|
|||
|
||||
Si vous constatez une erreur ou n'avez plus besoin d'un hébergeur, cliquez sur les ... sur la ligne de l'hébergeur concerné. Vous aurez alors la possibilité de choisir entre [mettre à jour les informations]({{% relref "provider-update" %}}) ou supprimer l'hébergeur :
|
||||
|
||||

|
||||

|
||||
|
||||
Notez que vous ne pourrez pas supprimer l'hébergeur tant que des domaines y faisant référence existeront dans la liste de gauche.
|
||||
|
||||
|
|
@ -48,10 +48,10 @@ Notez que vous ne pourrez pas supprimer l'hébergeur tant que des domaines y fai
|
|||
|
||||
Vous avez un nouveau domaine que vous souhaitez gérer dans happyDomain ? Commencez par entrer son nom dans le champ présent sous la liste. Vous serez ensuite guidé vers l'écran [permettant de choisir l'hébergeur]({{% relref "domain-new" %}}).
|
||||
|
||||

|
||||

|
||||
|
||||
Le champ n'apparaît pas lorsqu'un hébergeur est sélectionné à droite. Sauf si cet hébergeur ne permet pas de lister les domaines :
|
||||
Certains hébergeurs DNS vous permettent de créer un domaine directement dans leur base de données, même s'il n'était pas déjà enregistré. Vous devrez d'abord sélectionner le bon hébergeur. Vous verrez alors un bouton « Créer sur » dédié.
|
||||
|
||||

|
||||

|
||||
|
||||
Dans ce cas, la validation du champ recherchera automatiquement le nouveau domaine auprès de l'hébergeur sélectionné, comme l'indique le message juste au dessus du champ.
|
||||
Certains hébergeurs peuvent vous facturer cette action, soyez donc attentif si cela implique d'acheter réellement le domaine.
|
||||
|
|
|
|||
BIN
content/pages/domains/create-domain-on-provider.webp
Normal file
|
After Width: | Height: | Size: 18 KiB |
|
Before Width: | Height: | Size: 83 KiB |
BIN
content/pages/domains/domain-list.webp
Normal file
|
After Width: | Height: | Size: 36 KiB |
BIN
content/pages/domains/filtered-by-provider.webp
Normal file
|
After Width: | Height: | Size: 25 KiB |
|
Before Width: | Height: | Size: 73 KiB |
|
Before Width: | Height: | Size: 69 KiB |
|
Before Width: | Height: | Size: 71 KiB |
|
Before Width: | Height: | Size: 83 KiB |
|
Before Width: | Height: | Size: 83 KiB |
BIN
content/pages/domains/new-domain.webp
Normal file
|
After Width: | Height: | Size: 12 KiB |
BIN
content/pages/domains/provider-menu.webp
Normal file
|
After Width: | Height: | Size: 14 KiB |
BIN
content/pages/domains/providers-list.webp
Normal file
|
After Width: | Height: | Size: 20 KiB |
BIN
content/pages/import-export/happydomain-export-zone.webp
Normal file
|
After Width: | Height: | Size: 111 KiB |
BIN
content/pages/import-export/happydomain-modal-import-zone.webp
Normal file
|
After Width: | Height: | Size: 7.6 KiB |
63
content/pages/import-export/index.en.md
Normal file
|
|
@ -0,0 +1,63 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: "Importing and exporting a zone"
|
||||
author: nemunaire
|
||||
weight: 1600
|
||||
description: "Bring an existing zone file into happyDomain, or export your zone in standard BIND format"
|
||||
---
|
||||
|
||||
happyDomain can exchange your zone with the rest of the DNS world using the standard zone file format (the well-known BIND format). You can **import** a zone file to populate your working copy, and **export** the current zone to read it, copy it, or keep it elsewhere.
|
||||
|
||||
These actions are available from the gear menu at the top of the zone editor sidebar.
|
||||
|
||||
## Re-importing the live zone
|
||||
|
||||
Before working with files, it is worth knowing that you can always pull the **current** zone back from your provider. In the gear menu, choose **Retrieve the current zone**.
|
||||
|
||||
This contacts your hosting provider, reads the zone as it stands right now, and refreshes your working copy from it. Use it when the zone may have been changed outside happyDomain, or to start again from a clean state.
|
||||
|
||||
{{% notice style="warning" title="This replaces unpublished edits" icon="triangle-exclamation" %}}
|
||||
Re-importing the live zone fetches the provider's version. Any local change you had not yet published may be superseded, so review your pending changes first (see {{% relref "publish-changes" %}}) if you want to keep them.
|
||||
{{% /notice %}}
|
||||
|
||||
## Importing a zone file
|
||||
|
||||
To load a zone from a standard zone file:
|
||||
|
||||
1. Open the gear menu in the sidebar and choose the **upload / import a zone** action.
|
||||
2. A dialog opens with two tabs:
|
||||
- **From text** -- paste the content of a zone file directly into the text area.
|
||||
- **From a zone file** -- select a file from your computer.
|
||||
3. Click the upload button to send it.
|
||||
|
||||

|
||||
|
||||
happyDomain parses the zone file, recognises the records, and groups them back into services in your working copy. As with every other edit, the imported content stays local until you publish it.
|
||||
|
||||
{{% notice style="info" title="Standard format" icon="circle-info" %}}
|
||||
The expected format is the standard textual zone file, the same one BIND and most DNS tools use. A line such as `@ 4269 IN SOA root ns 2042070136 ...` is a typical example of what you can paste.
|
||||
{{% /notice %}}
|
||||
|
||||
## Exporting / viewing the zone
|
||||
|
||||
To obtain your zone as a standard zone file:
|
||||
|
||||
1. Open the gear menu and choose **View my zone**.
|
||||
2. happyDomain renders the current zone in standard BIND format, with syntax highlighting.
|
||||
3. Use the **Copy to clipboard** button to grab the whole file in one click.
|
||||
|
||||

|
||||
|
||||
This view always reflects the zone you are currently looking at. If you are browsing a past version from the {{% relref "domain-history" %}}, the export shows that historical version, which is handy for comparing or restoring an earlier state.
|
||||
|
||||
## Typical workflows
|
||||
|
||||
- **Migrating from another tool**: export the zone from your previous tool as a zone file, then import it here with **From a zone file**.
|
||||
- **Keeping a backup**: open **View my zone** and copy the content somewhere safe.
|
||||
- **Bulk editing**: export, edit the file in your favourite editor, then re-import the result.
|
||||
|
||||
## After importing
|
||||
|
||||
Importing only changes your working copy. To make it effective at your provider:
|
||||
|
||||
1. Review the resulting diff and publish the changes (see {{% relref "publish-changes" %}}).
|
||||
63
content/pages/import-export/index.fr.md
Normal file
|
|
@ -0,0 +1,63 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: "Importer et exporter une zone"
|
||||
author: nemunaire
|
||||
weight: 1600
|
||||
description: "Importer un fichier de zone existant dans happyDomain, ou exporter votre zone au format BIND standard"
|
||||
---
|
||||
|
||||
happyDomain peut échanger votre zone avec le reste du monde DNS en utilisant le format de fichier de zone standard (le célèbre format BIND). Vous pouvez **importer** un fichier de zone pour alimenter votre copie de travail, et **exporter** la zone actuelle pour la lire, la copier ou la conserver ailleurs.
|
||||
|
||||
Ces actions sont accessibles depuis le menu en forme d'engrenage situé en haut de la barre latérale de l'éditeur de zone.
|
||||
|
||||
## Réimporter la zone en ligne
|
||||
|
||||
Avant de travailler avec des fichiers, il est utile de savoir que vous pouvez toujours récupérer la zone **actuelle** auprès de votre hébergeur. Dans le menu engrenage, choisissez « Récupérer la zone actuelle ».
|
||||
|
||||
Cette action contacte votre hébergeur, lit la zone telle qu'elle est en ce moment, et rafraîchit votre copie de travail à partir d'elle. Utilisez-la lorsque la zone a pu être modifiée en dehors de happyDomain, ou pour repartir d'un état propre.
|
||||
|
||||
{{% notice style="warning" title="Cela remplace les modifications non publiées" icon="triangle-exclamation" %}}
|
||||
Réimporter la zone en ligne récupère la version de l'hébergeur. Tout changement local que vous n'aviez pas encore publié peut être écrasé : examinez donc d'abord [vos changements en attente]({{% relref "publish-changes" %}}) si vous souhaitez les conserver.
|
||||
{{% /notice %}}
|
||||
|
||||
## Importer un fichier de zone
|
||||
|
||||
Pour charger une zone à partir d'un fichier de zone standard :
|
||||
|
||||
1. Ouvrez le menu engrenage de la barre latérale et choisissez l'action d'import de zone.
|
||||
2. Une fenêtre s'ouvre avec deux onglets :
|
||||
- **Depuis du texte** : collez le contenu d'un fichier de zone directement dans la zone de saisie.
|
||||
- **Depuis un fichier de zone** : sélectionnez un fichier sur votre ordinateur.
|
||||
3. Cliquez sur le bouton d'envoi pour le transmettre.
|
||||
|
||||

|
||||
|
||||
happyDomain analyse le fichier de zone, reconnaît les enregistrements et les regroupe à nouveau en services dans votre copie de travail. Comme pour toute autre modification, le contenu importé reste local tant que vous ne l'avez pas publié.
|
||||
|
||||
{{% notice style="info" title="Format standard" icon="circle-info" %}}
|
||||
Le format attendu est le fichier de zone textuel standard, le même que celui qu'utilisent BIND et la plupart des outils DNS. Une ligne telle que `@ 4269 IN SOA root ns 2042070136 ...` est un exemple typique de ce que vous pouvez coller.
|
||||
{{% /notice %}}
|
||||
|
||||
## Exporter / visualiser la zone
|
||||
|
||||
Pour obtenir votre zone sous forme de fichier de zone standard :
|
||||
|
||||
1. Ouvrez le menu engrenage et choisissez « Voir ma zone ».
|
||||
2. happyDomain affiche la zone actuelle au format BIND standard, avec coloration syntaxique.
|
||||
3. Utilisez le bouton **Copier dans le presse-papier** pour récupérer le fichier entier en un clic.
|
||||
|
||||

|
||||
|
||||
Cette vue reflète toujours la zone que vous consultez actuellement. Si vous parcourez une version passée depuis l'[historique]({{% relref "domain-history" %}}), l'export montre cette version historique, ce qui est pratique pour comparer ou restaurer un état antérieur.
|
||||
|
||||
## Cas d'usage typiques
|
||||
|
||||
- **Migrer depuis un autre outil** : exportez la zone de votre outil précédent sous forme de fichier de zone, puis importez-la ici avec « Depuis un fichier de zone ».
|
||||
- **Conserver une sauvegarde** : ouvrez « Voir ma zone » et copiez le contenu dans un endroit sûr.
|
||||
- **Édition en masse** : exportez, modifiez le fichier dans votre éditeur favori, puis réimportez le résultat.
|
||||
|
||||
## Après un import
|
||||
|
||||
Un import ne modifie que votre copie de travail. Pour le rendre effectif chez votre hébergeur :
|
||||
|
||||
1. Examinez le différentiel obtenu, puis [publiez les changements]({{% relref "publish-changes" %}}).
|
||||
BIN
content/pages/login/happydomain-forget-password-page.webp
Normal file
|
After Width: | Height: | Size: 14 KiB |
BIN
content/pages/login/happydomain-login-page.webp
Normal file
|
After Width: | Height: | Size: 22 KiB |
45
content/pages/login/index.en.md
Normal file
|
|
@ -0,0 +1,45 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Log in
|
||||
author: nemunaire
|
||||
weight: 200
|
||||
description: "Sign in to happyDomain and recover a forgotten password"
|
||||
---
|
||||
|
||||
Once you have [created an account]({{% relref "signup" %}}) and validated your email address, you can sign in to access your domains.
|
||||
|
||||
## Signing in
|
||||
|
||||
On the login page, enter the email address and password you chose at registration, then click **Go**.
|
||||
|
||||

|
||||
|
||||
If the credentials are correct, you are taken to your dashboard. If they are not, an error message is displayed: double-check your address and password and try again.
|
||||
|
||||
{{% notice style="info" title="Repeated attempts" icon="shield" %}}
|
||||
For security reasons, the server may ask you to complete an anti-bot challenge (captcha) after a few failed attempts, or temporarily rate-limit further tries. Wait a moment, then retry.
|
||||
{{% /notice %}}
|
||||
|
||||
### Signing in with an external provider
|
||||
|
||||
When the server is configured for it, an additional button lets you sign in through an external identity provider (for example Google, GitLab, GitHub, Microsoft or Apple). Click it to be redirected to that provider and authenticate there.
|
||||
|
||||
## Forgotten password
|
||||
|
||||
If you no longer remember your password, click **Forgotten password?** below the login form.
|
||||
|
||||

|
||||
|
||||
Enter the email address of your account and click **Send the recovery link**. If an account matches, a message containing a recovery link is sent to that address.
|
||||
|
||||
Open the link from your mailbox to reach the account recovery form, where you can set a new password:
|
||||
|
||||
1. Type your **new password** (it must meet the same strength requirements as at sign-up).
|
||||
2. Retype it in the **confirmation** field.
|
||||
3. Click **Redefine my password**.
|
||||
|
||||
Once the password is redefined, you are redirected to the login page to sign in with your new credentials.
|
||||
|
||||
{{% notice style="warning" title="Servers without email" icon="triangle-exclamation" %}}
|
||||
On instances that run without a mail service, password recovery is not available: clicking **Forgotten password?** displays a notice inviting you to contact the server administrator to reset your password.
|
||||
{{% /notice %}}
|
||||
44
content/pages/login/index.fr.md
Normal file
|
|
@ -0,0 +1,44 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Se connecter
|
||||
weight: 200
|
||||
description: "Connectez-vous à happyDomain et récupérez un mot de passe oublié"
|
||||
---
|
||||
|
||||
Une fois votre [compte créé]({{% relref "signup" %}}) et votre adresse e-mail validée, vous pouvez vous connecter pour accéder à vos domaines.
|
||||
|
||||
## Se connecter
|
||||
|
||||
Sur la page de connexion, saisissez l'adresse e-mail et le mot de passe choisis lors de l'inscription, puis cliquez sur « C'est parti ».
|
||||
|
||||

|
||||
|
||||
Si les identifiants sont corrects, vous arrivez sur votre tableau de bord. Sinon, un message d'erreur s'affiche : vérifiez votre adresse et votre mot de passe, puis réessayez.
|
||||
|
||||
{{% notice style="info" title="Tentatives répétées" icon="shield" %}}
|
||||
Pour des raisons de sécurité, le serveur peut vous demander de compléter une vérification anti-robot (captcha) après plusieurs échecs, ou limiter temporairement les nouvelles tentatives. Patientez un instant, puis réessayez.
|
||||
{{% /notice %}}
|
||||
|
||||
### Se connecter avec un fournisseur externe
|
||||
|
||||
Lorsque le serveur est configuré pour cela, un bouton supplémentaire permet de se connecter via un fournisseur d'identité externe (par exemple Google, GitLab, GitHub, Microsoft ou Apple). Cliquez dessus pour être redirigé vers ce fournisseur et vous y authentifier.
|
||||
|
||||
## Mot de passe oublié
|
||||
|
||||
Si vous ne vous souvenez plus de votre mot de passe, cliquez sur « Mot de passe oublié ? » sous le formulaire de connexion.
|
||||
|
||||

|
||||
|
||||
Saisissez l'adresse e-mail de votre compte, puis cliquez sur « Envoyer le lien de récupération ». Si un compte correspond, un message contenant un lien de récupération est envoyé à cette adresse.
|
||||
|
||||
Ouvrez le lien depuis votre messagerie pour accéder au formulaire de récupération de compte, où vous pourrez définir un nouveau mot de passe :
|
||||
|
||||
1. Saisissez votre **nouveau mot de passe** (il doit respecter les mêmes exigences de robustesse qu'à l'inscription).
|
||||
2. Ressaisissez-le dans le champ de **confirmation**.
|
||||
3. Cliquez sur « Redéfinir mon mot de passe ».
|
||||
|
||||
Une fois le mot de passe redéfini, vous êtes redirigé vers la page de connexion pour vous identifier avec vos nouveaux identifiants.
|
||||
|
||||
{{% notice style="warning" title="Serveurs sans e-mail" icon="triangle-exclamation" %}}
|
||||
Sur les instances fonctionnant sans service de messagerie, la récupération de mot de passe n'est pas disponible : cliquer sur « Mot de passe oublié ? » affiche un message vous invitant à contacter l'administrateur du serveur pour réinitialiser votre mot de passe.
|
||||
{{% /notice %}}
|
||||
|
|
@ -1,31 +0,0 @@
|
|||
---
|
||||
date: 2021-01-12T21:38:49+02:00
|
||||
title: "Set up your profile"
|
||||
author: Frederic
|
||||
weight: 40
|
||||
---
|
||||
|
||||
You access this page by clicking on the top menu "My Account" link.
|
||||
|
||||
## Account Settings
|
||||
|
||||
The screen is divided into three parts. The first one will allow you to change the settings related to your account: such as the language of the interface or the way the contextual help is displayed.
|
||||
|
||||
|
||||
## Change password
|
||||
|
||||
The second part of the screen allows you to change the password.
|
||||
|
||||
|
||||
## Change account email address
|
||||
|
||||
It is currently not possible to change the email address of your account. We invite you to contact us if you wish to change it.
|
||||
|
||||
|
||||
## Delete your account
|
||||
|
||||
The last part of the page allows you to delete your happyDomain account.
|
||||
|
||||
Once the deletion is validated, your account will no longer be accessible and all data belonging to you will be deleted shortly after, during a regular database cleanup.
|
||||
|
||||
From the moment you delete your account, your domains will continue to respond according to the last update you made on happyDomain. The deletion will not affect the distributed data.
|
||||
|
|
@ -1,30 +0,0 @@
|
|||
---
|
||||
date: 2020-12-10T10:26:54+01:00
|
||||
title: "Paramétrer son profil"
|
||||
weight: 40
|
||||
---
|
||||
|
||||
Vous accédez à cette page en cliquant sur le lien « Mon compte » dans le menu en haut.
|
||||
|
||||
## Paramètres du compte
|
||||
|
||||
L'écran est divisé en 3 parties. La première va vous permettre de modifier les paramètres liés à votre compte : tel que la langue de l'interface ou la manière dont l'aide contextuelle est affichée.
|
||||
|
||||
|
||||
## Changer de mot de passe
|
||||
|
||||
La seconde partie de l'écran vous permet de changer de mot de passe.
|
||||
|
||||
|
||||
## Changer l'adresse électronique de compte
|
||||
|
||||
Il n'est pour l'instant pas possible de changer l'adresse électronique de votre compte. Nous vous invitons à nous contacter si vous souhaitez la changer.
|
||||
|
||||
|
||||
## Supprimer son compte
|
||||
|
||||
La dernière partie de la page vous permet de supprimer votre compte happyDomain.
|
||||
|
||||
Une fois la suppression validée, votre compte ne sera plus accessible et l'ensemble des données vous appartenant sera supprimé peu de temps après, lors d'un nettoyage régulier de la base de données.
|
||||
|
||||
À partir du moment où vous supprimez votre compte, vos domaines continueront de répondre selon la dernière mise à jour que vous avez effectué sur happyDomain. La suppression n'affectera pas les données distribuées.
|
||||
116
content/pages/notifications.en.md
Normal file
|
|
@ -0,0 +1,116 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Notifications
|
||||
author: nemunaire
|
||||
weight: 2300
|
||||
description: "Receive alerts when your monitoring checks change state, and configure where and when those alerts are delivered"
|
||||
---
|
||||
|
||||
happyDomain can notify you when something changes on your domains. Notifications are driven by the [monitoring & checks]({{% relref "checks" %}}) system: whenever a checker changes status (for example from **OK** to **Warning**, or back to **OK** after a problem), happyDomain can deliver an alert to the channels you have configured.
|
||||
|
||||
You manage notifications from the **Notifications** page in your account settings. It is organised into three tabs: **Channels**, **Preferences** and **History**.
|
||||
|
||||
<!-- TODO: screenshot of the notifications page with its three tabs -->
|
||||
|
||||
|
||||
## What triggers a notification
|
||||
|
||||
Notifications are tied to your checkers. happyDomain watches the status reported by each check and sends a notification when:
|
||||
|
||||
- a check **degrades** to (or beyond) a severity you care about, for example reaching **Warning**, **Critical** or **Error**;
|
||||
- a check **recovers**, returning to a healthy state, if you have asked to be notified of recoveries.
|
||||
|
||||
Each notification therefore describes a status transition (the previous status and the new status) for a given target. Which transitions reach you, and through which channels, is entirely controlled by your **preferences** (see below).
|
||||
|
||||
|
||||
## Channels
|
||||
|
||||
A **channel** is a destination where notifications are sent. Open the **Channels** tab to manage them.
|
||||
|
||||
To add one, click **Add**, choose a **Type**, give it a **Name** (so you can recognise it later) and fill in the type-specific fields. A channel can be **enabled** or disabled with a switch without deleting it.
|
||||
|
||||
happyDomain offers the following channel types out of the box:
|
||||
|
||||
### Email
|
||||
|
||||
Sends notifications to an email address.
|
||||
|
||||
- **Email address**: the recipient. If left empty, the notification is sent to your account's email address.
|
||||
|
||||
### Webhook
|
||||
|
||||
Sends an HTTP request to a URL of your choice, which is useful to integrate happyDomain with chat tools, automation platforms or your own services.
|
||||
|
||||
- **Webhook URL** (required): the endpoint that will receive the notification.
|
||||
- **Webhook headers**: optional custom HTTP headers (name/value pairs) to add to the request, for example an authorization header.
|
||||
- **Webhook secret**: an optional secret used to sign the request so the receiver can verify it really comes from happyDomain.
|
||||
|
||||
### UnifiedPush
|
||||
|
||||
Delivers push notifications to your devices through a [UnifiedPush](https://unifiedpush.org/) distributor.
|
||||
|
||||
- **UnifiedPush endpoint** (required): the endpoint URL provided by your UnifiedPush application.
|
||||
|
||||
{{% notice style="info" title="Other channel types" icon="circle-info" %}}
|
||||
The list of available types depends on what the instance administrator has enabled. For types that happyDomain does not provide a dedicated form for, the editor falls back to a raw JSON configuration field.
|
||||
{{% /notice %}}
|
||||
|
||||
### Testing a channel
|
||||
|
||||
Once a channel is created and enabled, use the **send/test** button next to it to deliver a test notification. This confirms the configuration works before relying on it for real alerts.
|
||||
|
||||
<!-- TODO: screenshot of the channels list with the test button -->
|
||||
|
||||
|
||||
## Preferences
|
||||
|
||||
Channels say *where* notifications go; **preferences** say *what* gets sent and *when*. Open the **Preferences** tab and click **Add** to create a rule.
|
||||
|
||||
A preference combines the following settings:
|
||||
|
||||
### Scope
|
||||
|
||||
Choose how broadly the rule applies:
|
||||
|
||||
- **Global**: applies to all your domains and services.
|
||||
- **Domain**: applies to a single domain you select.
|
||||
- **Service**: applies to a specific service (you select the domain and provide the service identifier).
|
||||
|
||||
### Channels
|
||||
|
||||
Select one or more of your configured channels to receive the notifications matching this preference. If you have no channels yet, create one first in the **Channels** tab.
|
||||
|
||||
### Minimum status
|
||||
|
||||
Pick the lowest severity that should trigger a notification. The available levels, in increasing severity, are **OK**, **Info**, **Warning**, **Critical** and **Error**. Only status changes that reach this level (or higher) are notified. For example, choosing **Warning** means you are alerted on Warning, Critical and Error, but not on purely informational changes.
|
||||
|
||||
### Notify on recovery
|
||||
|
||||
When enabled, you also receive a notification when a previously degraded check returns to a healthy state, so you know when a problem has been resolved.
|
||||
|
||||
### Quiet hours
|
||||
|
||||
Optionally define a period during which notifications are held back, for instance overnight. Set a **start** hour and an **end** hour (0 to 23). When quiet hours are active, alerts raised within that window are not sent immediately.
|
||||
|
||||
### Enabled
|
||||
|
||||
Each preference can be turned on or off with a switch, letting you temporarily suspend a rule without deleting it.
|
||||
|
||||
<!-- TODO: screenshot of the preference editor -->
|
||||
|
||||
{{% notice style="tip" title="Start simple" icon="lightbulb" %}}
|
||||
A common setup is a single **Global** preference, pointing at one channel, with a minimum status of **Warning** and recovery notifications enabled. You can later add more specific per-domain or per-service rules as your needs grow.
|
||||
{{% /notice %}}
|
||||
|
||||
|
||||
## History
|
||||
|
||||
The **History** tab lists the notifications happyDomain has attempted to send. For each entry you can see:
|
||||
|
||||
- the target concerned;
|
||||
- the status transition (previous status → new status);
|
||||
- whether delivery **succeeded** or **failed** (with the error message when it failed).
|
||||
|
||||
Use **Load more** to page back through older entries. This view is the place to check why an expected alert did not reach you, for example a channel misconfiguration causing repeated failures.
|
||||
|
||||
<!-- TODO: screenshot of the notification history list -->
|
||||
115
content/pages/notifications.fr.md
Normal file
|
|
@ -0,0 +1,115 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Notifications
|
||||
weight: 2300
|
||||
description: "Recevoir des alertes lorsque vos contrôles de supervision changent d'état, et configurer où et quand ces alertes sont délivrées"
|
||||
---
|
||||
|
||||
happyDomain peut vous prévenir lorsque quelque chose change sur vos domaines. Les notifications reposent sur le système de [supervision et contrôles]({{% relref "checks" %}}) : chaque fois qu'un contrôle change de statut (par exemple de **OK** à **Avertissement**, ou un retour à **OK** après un problème), happyDomain peut envoyer une alerte vers les canaux que vous avez configurés.
|
||||
|
||||
Vous gérez les notifications depuis la page **Notifications** des paramètres de votre compte. Elle s'organise en trois onglets : **Canaux**, **Préférences** et **Historique**.
|
||||
|
||||
<!-- TODO: screenshot of the notifications page with its three tabs -->
|
||||
|
||||
|
||||
## Ce qui déclenche une notification
|
||||
|
||||
Les notifications sont liées à vos contrôles. happyDomain surveille le statut rapporté par chaque contrôle et envoie une notification lorsque :
|
||||
|
||||
- un contrôle **se dégrade** jusqu'à (ou au-delà d') une gravité qui vous importe, par exemple en atteignant **Avertissement**, **Critique** ou **Erreur** ;
|
||||
- un contrôle **se rétablit**, en revenant à un état sain, si vous avez demandé à être prévenu des rétablissements.
|
||||
|
||||
Chaque notification décrit donc une transition de statut (l'ancien statut et le nouveau) pour une cible donnée. Les transitions qui vous parviennent, et par quels canaux, sont entièrement déterminées par vos **préférences** (voir ci-dessous).
|
||||
|
||||
|
||||
## Canaux
|
||||
|
||||
Un **canal** est une destination vers laquelle les notifications sont envoyées. Ouvrez l'onglet **Canaux** pour les gérer.
|
||||
|
||||
Pour en ajouter un, cliquez sur **Ajouter**, choisissez un **Type**, donnez-lui un **Nom** (afin de le reconnaître par la suite) et renseignez les champs propres à ce type. Un canal peut être **activé** ou désactivé à l'aide d'un interrupteur, sans avoir à le supprimer.
|
||||
|
||||
happyDomain propose les types de canaux suivants d'origine :
|
||||
|
||||
### E-mail
|
||||
|
||||
Envoie les notifications à une adresse e-mail.
|
||||
|
||||
- **Adresse e-mail** : le destinataire. Si le champ est laissé vide, la notification est envoyée à l'adresse e-mail de votre compte.
|
||||
|
||||
### Webhook
|
||||
|
||||
Envoie une requête HTTP vers une URL de votre choix, ce qui est utile pour intégrer happyDomain à des outils de discussion, des plateformes d'automatisation ou vos propres services.
|
||||
|
||||
- **URL du webhook** (obligatoire) : le point d'accès qui recevra la notification.
|
||||
- **En-têtes du webhook** : des en-têtes HTTP personnalisés facultatifs (paires nom/valeur) à ajouter à la requête, par exemple un en-tête d'autorisation.
|
||||
- **Secret du webhook** : un secret facultatif servant à signer la requête, afin que le destinataire puisse vérifier qu'elle provient bien de happyDomain.
|
||||
|
||||
### UnifiedPush
|
||||
|
||||
Délivre des notifications push sur vos appareils via un distributeur [UnifiedPush](https://unifiedpush.org/).
|
||||
|
||||
- **Point d'accès UnifiedPush** (obligatoire) : l'URL du point d'accès fournie par votre application UnifiedPush.
|
||||
|
||||
{{% notice style="info" title="Autres types de canaux" icon="circle-info" %}}
|
||||
La liste des types disponibles dépend de ce que l'administrateur de l'instance a activé. Pour les types pour lesquels happyDomain ne propose pas de formulaire dédié, l'éditeur bascule sur un champ de configuration JSON brut.
|
||||
{{% /notice %}}
|
||||
|
||||
### Tester un canal
|
||||
|
||||
Une fois un canal créé et activé, utilisez le bouton d'envoi/test situé à côté de lui pour délivrer une notification de test. Cela confirme que la configuration fonctionne avant de compter dessus pour de vraies alertes.
|
||||
|
||||
<!-- TODO: screenshot of the channels list with the test button -->
|
||||
|
||||
|
||||
## Préférences
|
||||
|
||||
Les canaux indiquent *où* vont les notifications ; les **préférences** indiquent *quoi* est envoyé et *quand*. Ouvrez l'onglet **Préférences** puis cliquez sur **Ajouter** pour créer une règle.
|
||||
|
||||
Une préférence combine les réglages suivants :
|
||||
|
||||
### Portée
|
||||
|
||||
Choisissez l'étendue d'application de la règle :
|
||||
|
||||
- **Globale** : s'applique à l'ensemble de vos domaines et services.
|
||||
- **Domaine** : s'applique à un seul domaine que vous sélectionnez.
|
||||
- **Service** : s'applique à un service précis (vous sélectionnez le domaine et fournissez l'identifiant du service).
|
||||
|
||||
### Canaux
|
||||
|
||||
Sélectionnez un ou plusieurs de vos canaux configurés pour recevoir les notifications correspondant à cette préférence. Si vous n'avez pas encore de canal, créez-en un d'abord dans l'onglet **Canaux**.
|
||||
|
||||
### Statut minimum
|
||||
|
||||
Choisissez la gravité la plus basse qui doit déclencher une notification. Les niveaux disponibles, par gravité croissante, sont **OK**, **Info**, **Avertissement**, **Critique** et **Erreur**. Seuls les changements de statut qui atteignent ce niveau (ou un niveau supérieur) sont notifiés. Par exemple, choisir **Avertissement** signifie que vous êtes alerté pour les états Avertissement, Critique et Erreur, mais pas pour les changements purement informatifs.
|
||||
|
||||
### Notifier le rétablissement
|
||||
|
||||
Lorsque cette option est activée, vous recevez également une notification quand un contrôle auparavant dégradé revient à un état sain, afin de savoir qu'un problème a été résolu.
|
||||
|
||||
### Heures calmes
|
||||
|
||||
Vous pouvez définir une période durant laquelle les notifications sont retenues, par exemple la nuit. Indiquez une heure de **début** et une heure de **fin** (de 0 à 23). Lorsque les heures calmes sont actives, les alertes survenant dans cette plage ne sont pas envoyées immédiatement.
|
||||
|
||||
### Activée
|
||||
|
||||
Chaque préférence peut être activée ou désactivée à l'aide d'un interrupteur, ce qui permet de suspendre temporairement une règle sans la supprimer.
|
||||
|
||||
<!-- TODO: screenshot of the preference editor -->
|
||||
|
||||
{{% notice style="tip" title="Commencez simplement" icon="lightbulb" %}}
|
||||
Une configuration courante consiste en une unique préférence **Globale**, pointant vers un canal, avec un statut minimum d'**Avertissement** et les notifications de rétablissement activées. Vous pourrez ensuite ajouter des règles plus spécifiques par domaine ou par service au fur et à mesure de vos besoins.
|
||||
{{% /notice %}}
|
||||
|
||||
|
||||
## Historique
|
||||
|
||||
L'onglet **Historique** liste les notifications que happyDomain a tenté d'envoyer. Pour chaque entrée, vous pouvez voir :
|
||||
|
||||
- la cible concernée ;
|
||||
- la transition de statut (ancien statut → nouveau statut) ;
|
||||
- si l'envoi a **réussi** ou **échoué** (avec le message d'erreur en cas d'échec).
|
||||
|
||||
Utilisez **Charger plus** pour remonter dans les entrées plus anciennes. Cette vue est l'endroit où vérifier pourquoi une alerte attendue ne vous est pas parvenue, par exemple un canal mal configuré provoquant des échecs répétés.
|
||||
|
||||
<!-- TODO: screenshot of the notification history list -->
|
||||
45
content/pages/provider-features.en.md
Normal file
|
|
@ -0,0 +1,45 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Provider features
|
||||
author: nemunaire
|
||||
weight: 700
|
||||
description: "Compare what each DNS provider supports with the provider feature matrix"
|
||||
---
|
||||
|
||||
Not every DNS provider supports the same set of capabilities. Some can list the domains in your account automatically, others handle only the most common record types, and a few support more specialised records such as `CAA` or `TLSA`. The **Supported providers** page presents this information as a single comparison table so you can pick the right provider, or understand why a given [service]({{% relref "services" %}}) is unavailable for one of your domains.
|
||||
|
||||
## Reading the feature matrix
|
||||
|
||||
The page lists every provider happyDomain integrates with, one per row, with its logo and name. Each column corresponds to a capability, and the cell shows whether that provider supports it:
|
||||
|
||||
- a green check mark means the capability **is supported**;
|
||||
- a red cross means it **is not supported**.
|
||||
|
||||
<!-- TODO: screenshot of the provider feature matrix -->
|
||||
|
||||
The table scrolls horizontally if it is wider than your screen, and the header row stays visible while you scroll, so you can always tell which capability each column refers to.
|
||||
|
||||
## The capabilities
|
||||
|
||||
The matrix compares the following capabilities:
|
||||
|
||||
| Column | Meaning |
|
||||
|--------|---------|
|
||||
| **Supported providers** | The provider can automatically list the domains in your account, so you can import them without typing each name. When unsupported, you add domains manually. |
|
||||
| **Common types** | The provider supports the everyday record types (such as `A`, `AAAA`, `MX`, `TXT`, `CNAME`). This is what most domains need. |
|
||||
| **CAA** | Support for `CAA` records, which declare the certificate authorities allowed to issue certificates for your domain. |
|
||||
| **OPENPGPKEY** | Support for `OPENPGPKEY` records, used to publish OpenPGP public keys in DNS. |
|
||||
| **PTR** | Support for `PTR` records, used mainly for reverse DNS (mapping an IP address back to a name). |
|
||||
| **SRV** | Support for `SRV` records, which advertise the location of a service (port and host) for protocols that rely on them. |
|
||||
| **SSHFP** | Support for `SSHFP` records, which publish SSH host key fingerprints in DNS. |
|
||||
| **TLSA** | Support for `TLSA` records, used by DANE to bind a certificate to a name. |
|
||||
|
||||
{{% notice style="info" title="Why this matters" icon="circle-info" %}}
|
||||
When you add a [service]({{% relref "services" %}}) to a subdomain, happyDomain only offers the service types your provider can actually publish. If a service you expect is greyed out, the feature matrix is the place to confirm whether the underlying record type is supported by that provider.
|
||||
{{% /notice %}}
|
||||
|
||||
## Choosing a provider
|
||||
|
||||
If you are still deciding where to host your DNS, use this page to make sure the provider you have in mind covers the record types you need. A provider that supports the **Common types** is enough for most websites and email setups; the specialised columns matter only if you rely on the corresponding features (DANE, reverse DNS, SSH fingerprints, and so on).
|
||||
|
||||
Once you have picked a provider, head over to [add it]({{% relref "provider-new-choice" %}}) to happyDomain.
|
||||
44
content/pages/provider-features.fr.md
Normal file
|
|
@ -0,0 +1,44 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Fonctionnalités des fournisseurs
|
||||
weight: 700
|
||||
description: "Comparer ce que prend en charge chaque hébergeur DNS grâce à la matrice des fonctionnalités"
|
||||
---
|
||||
|
||||
Tous les hébergeurs DNS ne prennent pas en charge les mêmes capacités. Certains savent lister automatiquement les domaines de votre compte, d'autres ne gèrent que les types d'enregistrements les plus courants, et quelques-uns prennent en charge des enregistrements plus spécialisés comme `CAA` ou `TLSA`. La page **Fournisseurs supportés** présente ces informations sous la forme d'un unique tableau comparatif, afin de vous aider à choisir le bon hébergeur, ou à comprendre pourquoi un [service]({{% relref "services" %}}) donné n'est pas disponible pour l'un de vos domaines.
|
||||
|
||||
## Lire la matrice des fonctionnalités
|
||||
|
||||
La page liste tous les hébergeurs avec lesquels happyDomain s'intègre, un par ligne, avec son logo et son nom. Chaque colonne correspond à une capacité, et la cellule indique si l'hébergeur la prend en charge :
|
||||
|
||||
- une coche verte signifie que la capacité **est prise en charge** ;
|
||||
- une croix rouge signifie qu'elle **n'est pas prise en charge**.
|
||||
|
||||
<!-- TODO: capture d'écran de la matrice des fonctionnalités des fournisseurs -->
|
||||
|
||||
Le tableau défile horizontalement s'il est plus large que votre écran, et la ligne d'en-tête reste visible pendant le défilement : vous savez ainsi toujours à quelle capacité se rapporte chaque colonne.
|
||||
|
||||
## Les capacités
|
||||
|
||||
La matrice compare les capacités suivantes :
|
||||
|
||||
| Colonne | Signification |
|
||||
|---------|---------------|
|
||||
| **Fournisseurs supportés** | L'hébergeur sait lister automatiquement les domaines de votre compte, ce qui vous permet de les importer sans saisir chaque nom. Lorsque ce n'est pas pris en charge, vous ajoutez les domaines manuellement. |
|
||||
| **Types courants** | L'hébergeur prend en charge les types d'enregistrements du quotidien (comme `A`, `AAAA`, `MX`, `TXT`, `CNAME`). C'est ce dont la plupart des domaines ont besoin. |
|
||||
| **CAA** | Prise en charge des enregistrements `CAA`, qui déclarent les autorités de certification autorisées à émettre des certificats pour votre domaine. |
|
||||
| **OPENPGPKEY** | Prise en charge des enregistrements `OPENPGPKEY`, utilisés pour publier des clés publiques OpenPGP dans le DNS. |
|
||||
| **PTR** | Prise en charge des enregistrements `PTR`, utilisés principalement pour le DNS inverse (associer une adresse IP à un nom). |
|
||||
| **SRV** | Prise en charge des enregistrements `SRV`, qui annoncent l'emplacement d'un service (port et hôte) pour les protocoles qui s'appuient dessus. |
|
||||
| **SSHFP** | Prise en charge des enregistrements `SSHFP`, qui publient les empreintes des clés d'hôte SSH dans le DNS. |
|
||||
| **TLSA** | Prise en charge des enregistrements `TLSA`, utilisés par DANE pour lier un certificat à un nom. |
|
||||
|
||||
{{% notice style="info" title="Pourquoi c'est important" icon="circle-info" %}}
|
||||
Lorsque vous ajoutez un [service]({{% relref "services" %}}) à un sous-domaine, happyDomain ne propose que les types de services que votre hébergeur peut réellement publier. Si un service que vous attendiez apparaît grisé, la matrice des fonctionnalités est l'endroit où vérifier si le type d'enregistrement sous-jacent est pris en charge par cet hébergeur.
|
||||
{{% /notice %}}
|
||||
|
||||
## Choisir un hébergeur
|
||||
|
||||
Si vous hésitez encore sur l'endroit où héberger votre DNS, servez-vous de cette page pour vous assurer que l'hébergeur envisagé couvre les types d'enregistrements dont vous avez besoin. Un hébergeur qui prend en charge les **types courants** suffit pour la plupart des sites web et des configurations de messagerie ; les colonnes spécialisées ne comptent que si vous utilisez les fonctionnalités correspondantes (DANE, DNS inverse, empreintes SSH, etc.).
|
||||
|
||||
Une fois votre hébergeur choisi, rendez-vous sur la page pour l'[ajouter]({{% relref "provider-new-choice" %}}) à happyDomain.
|
||||
|
|
@ -5,7 +5,7 @@ title: List your name providers
|
|||
aliases:
|
||||
hosters
|
||||
source-list
|
||||
weight: 15
|
||||
weight: 400
|
||||
---
|
||||
|
||||
You can access this page by clicking on the the top menu link "The hosts of my domains".
|
||||
|
|
@ -14,9 +14,9 @@ You can access this page by clicking on the the top menu link "The hosts of my d
|
|||
|
||||
This page shows only the list of registries and domain hosts you have added to your account, and [allows you to add more]({{% relref "provider-new-choice" %}}).
|
||||
|
||||

|
||||

|
||||
|
||||
You can add a new host by clicking on the "+" button at the top of the page.
|
||||
|
||||
By clicking on a row of the table, you will access the parameters used by happyDomain to contact this host.
|
||||
By clicking on a row of the table, you will access [the parameters used by happyDomain to contact this host]({{% relref "provider-update" %}}).
|
||||
This is where you'll be able to modify the name you gave to this host, and where you'll be able to modify the access parameters.
|
||||
|
|
|
|||
|
|
@ -4,18 +4,18 @@ title: Lister vos hébergeurs de noms
|
|||
aliases:
|
||||
hosters
|
||||
source-list
|
||||
weight: 15
|
||||
weight: 400
|
||||
---
|
||||
|
||||
Vous accédez à cette page en cliquant sur le lien « Les hôtes de mes domaines » dans le menu en haut.
|
||||
Vous accédez à cette page en cliquant sur le lien « Les hébergeurs de mes domaines » dans le menu en haut.
|
||||
|
||||
## Vos registres et hébergeurs de domaines
|
||||
|
||||
Cette page montre uniquement la liste des registres et des hébergeurs de domaines que vous avez ajouté à votre compte, et [vous permet d'en ajouter]({{% relref "provider-new-choice" %}}).
|
||||
|
||||

|
||||

|
||||
|
||||
Vous pouvez ajouter un nouvel hébergeur en cliquant sur le bouton +, présent en haut de la page.
|
||||
|
||||
En cliquant sur une ligne du tableau, vous accéderez aux paramètres qu'utilise happyDomain pour contacter cet hébergeur.
|
||||
En cliquant sur une ligne du tableau, vous accéderez aux [paramètres qu'utilise happyDomain pour contacter cet hébergeur]({{% relref "provider-update" %}}).
|
||||
C'est là que vous allez pouvoir modifier le nom que vous avez donné à cet hébergeur, et que vous pourrez modifier les paramètres d'accès.
|
||||
|
|
|
|||
|
Before Width: | Height: | Size: 60 KiB |
BIN
content/pages/provider-list/providers-list.webp
Normal file
|
After Width: | Height: | Size: 25 KiB |
|
|
@ -4,7 +4,7 @@ author: Frederic
|
|||
title: Add a provider
|
||||
aliases:
|
||||
source-new-choice
|
||||
weight: 17
|
||||
weight: 500
|
||||
---
|
||||
|
||||
You access this screen by clicking on the ["My domain providers"]({{% relref "provider-list" %}}) link in the top menu, then by clicking on the "+ Add a new domain host" button.
|
||||
|
|
|
|||
|
|
@ -3,7 +3,7 @@ date: 2020-12-09T18:12:45+01:00
|
|||
title: Ajouter un hébergeur
|
||||
aliases:
|
||||
source-new-choice
|
||||
weight: 17
|
||||
weight: 500
|
||||
---
|
||||
|
||||
Vous accédez à cet écran en cliquant sur le lien [« Les hébergeurs de mes domaines »]({{% relref "provider-list" %}}) dans le menu en haut, puis en cliquant sur le bouton « + Ajouter un nouvel hébergeur de domaines ».
|
||||
|
|
|
|||
|
|
@ -5,7 +5,7 @@ title: Hosting provider settings
|
|||
aliases:
|
||||
source-new-state
|
||||
source-update
|
||||
weight: 19
|
||||
weight: 600
|
||||
---
|
||||
|
||||
You access this screen either:
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@ title: Paramètres de l'hébergeur
|
|||
aliases:
|
||||
source-new-state
|
||||
source-update
|
||||
weight: 19
|
||||
weight: 600
|
||||
---
|
||||
|
||||
Vous accédez à cet écran soit :
|
||||
|
|
|
|||
|
|
@ -1,16 +0,0 @@
|
|||
---
|
||||
date: 2025-06-15T11:08:00+02:00
|
||||
title: "Publish modifications"
|
||||
weight: 40
|
||||
---
|
||||
|
||||
When you make a change in happyDomain, it is not directly passed on to your host or server.
|
||||
|
||||
Once you've made all the changes you wish to be propagated, click on the “Distribute my changes” button.
|
||||
|
||||
A window will open showing exactly which concrete changes will be passed on to your host or server.
|
||||
|
||||
If at this stage you don't want to apply all the changes, you can uncheck some of them.
|
||||
|
||||
Don't forget to enter a message in the appropriate field: this message will be recorded in your log.
|
||||
Later, when you need to see what changes you've made, it might be simpler to read “Changing host from Wordpress to Alwaysdata” rather than trying to interpret IP changes, ...
|
||||
|
|
@ -1,16 +0,0 @@
|
|||
---
|
||||
date: 2025-06-15T11:08:00+02:00
|
||||
title: "Publier des modifications"
|
||||
weight: 40
|
||||
---
|
||||
|
||||
Lorsque vous effectuez un changement dans happyDomain, celui-ci n'est pas directement répercuté auprès de votre hébergeur ou de votre serveur.
|
||||
|
||||
Une fois que vous avez fait toutes les modifications que vous souhaitez voir propagées, cliquez sur le bouton « Diffuser mes changements ».
|
||||
|
||||
Une fenêtre va s'ouvrir montrant précisément quelle modifications concrètes seront répercutées auprès de votre hébergeur ou de votre serveur.
|
||||
|
||||
Si à ce stade vous ne voulez pas appliquer tous les changements, vous pouvez en décocher certains.
|
||||
|
||||
N'oubliez pas d'indiquer un message dans le champs prévu à cet effet : ce message sera consigné dans votre journal.
|
||||
Plus tard, lorsque vous aurez besoin de voir quelles ont été vos modifications, cela pourrait s'avérer plus simple de lire « Changement d'hébergeur de Wordpress vers Alwaysdata » plutôt que de chercher à interpréter les changements d'IP, ...
|
||||
BIN
content/pages/publish-changes/happydomain-modal-diff-view.webp
Normal file
|
After Width: | Height: | Size: 38 KiB |
|
After Width: | Height: | Size: 1.8 KiB |
68
content/pages/publish-changes/index.en.md
Normal file
|
|
@ -0,0 +1,68 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: "Publishing changes"
|
||||
author: nemunaire
|
||||
weight: 1300
|
||||
description: "Review the diff of your pending changes, choose exactly which ones to apply, and publish them to your provider"
|
||||
---
|
||||
|
||||
When you make a change in happyDomain, it is not sent to your hosting provider straight away. Your edits accumulate in a working copy, and nothing reaches your provider until you decide to publish. Before that happens, happyDomain lets you review the exact list of changes that your edits produce, fine-tune what will be applied, and record a message for your history.
|
||||
|
||||
## Opening the diff
|
||||
|
||||
In the zone editor, the **Publish my changes** button shows a small counter with the number of pending changes detected for your zone. Click it to open the review window.
|
||||
|
||||

|
||||
|
||||
happyDomain computes the difference between the zone as it currently lives at your provider and the working copy you have been editing. If everything is already in sync, you will simply see a message telling you there is nothing to apply.
|
||||
|
||||
## Understanding the diff
|
||||
|
||||
Each line of the diff describes one concrete correction, written in a human-readable form and colour-coded by its nature:
|
||||
|
||||
| Colour | Meaning |
|
||||
|--------|---------|
|
||||
| **Green** | An addition (a record being created) |
|
||||
| **Red** | A deletion (a record being removed) |
|
||||
| **Yellow** | A modification (an existing record being changed) |
|
||||
| **Blue** | Another kind of change (for example a reordering or provider-specific operation) |
|
||||
|
||||
At the bottom of the window, a **summary** recaps how many additions, deletions and modifications are currently selected.
|
||||
|
||||

|
||||
|
||||
## Selecting which changes to apply
|
||||
|
||||
Every line in the diff has a checkbox. By default the changes are listed for your review, and you decide which ones to keep:
|
||||
|
||||
- **Uncheck** any change you do not want to apply right now. It stays in your working copy and will reappear next time.
|
||||
- Keep checked only the changes you are confident about.
|
||||
|
||||
This is useful when you have made several unrelated edits but only want to publish some of them, or when you want to roll out a sensitive change separately.
|
||||
|
||||
The summary and the apply button update live to reflect your current selection. If nothing is selected, the apply button stays disabled.
|
||||
|
||||
## Writing a commit message
|
||||
|
||||
Before applying, enter a message in the **What's changed?** field. This message is recorded in your history alongside the changes.
|
||||
|
||||
{{% notice style="tip" title="Describe the intent, not the IPs" icon="lightbulb" %}}
|
||||
The diff describes the technical operations, but your message is what makes your history readable later on. When you need to look back at what you did, "Move mail to a new provider" is far easier to understand than re-deriving meaning from a list of IP changes.
|
||||
{{% /notice %}}
|
||||
|
||||
## A confirmation step for safety
|
||||
|
||||
Depending on your [account preferences]({{% relref "settings" %}}), happyDomain may show an extra confirmation screen after you choose to apply:
|
||||
|
||||
- It asks your provider to **prepare** the corrections, then shows you exactly how many operations the provider will actually run for your selection.
|
||||
- If that number differs from what you selected (for instance because a change was already applied, or the provider expands one change into several), a warning is displayed so you can double-check before confirming.
|
||||
|
||||
You can configure whether this confirmation appears always, never, or only when the prepared corrections do not match your selection.
|
||||
|
||||
<!-- TODO: screenshot of the confirmation screen showing prepared corrections -->
|
||||
|
||||
## After publishing
|
||||
|
||||
Once you confirm, happyDomain sends the selected changes to your provider and records the operation, with your message, in the domain's log. From there you can review past deployments at any time, and roll back to an earlier state if needed; see {{% relref "domain-history" %}}.
|
||||
|
||||
To inspect the resulting zone itself rather than the diff, or to keep a copy as a standard zone file, see {{% relref "import-export" %}}.
|
||||
68
content/pages/publish-changes/index.fr.md
Normal file
|
|
@ -0,0 +1,68 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: "Publier des modifications"
|
||||
author: nemunaire
|
||||
weight: 1300
|
||||
description: "Examiner le différentiel de vos changements en attente, choisir précisément ceux à appliquer, et les publier chez votre hébergeur"
|
||||
---
|
||||
|
||||
Lorsque vous effectuez un changement dans happyDomain, celui-ci n'est pas immédiatement répercuté auprès de votre hébergeur. Vos modifications s'accumulent dans une copie de travail, et rien n'est transmis à votre hébergeur tant que vous n'avez pas décidé de publier. Avant cela, happyDomain vous permet d'examiner la liste exacte des changements produits par vos modifications, d'ajuster finement ce qui sera appliqué, et de consigner un message dans votre historique.
|
||||
|
||||
## Ouvrir le différentiel
|
||||
|
||||
Dans l'éditeur de zone, le bouton « Diffuser mes changements » affiche un petit compteur indiquant le nombre de changements en attente détectés pour votre zone. Cliquez dessus pour ouvrir la fenêtre de relecture.
|
||||
|
||||

|
||||
|
||||
happyDomain calcule la différence entre la zone telle qu'elle existe actuellement chez votre hébergeur et la copie de travail que vous avez éditée. Si tout est déjà synchronisé, un message vous indiquera simplement qu'il n'y a rien à appliquer.
|
||||
|
||||
## Comprendre le différentiel
|
||||
|
||||
Chaque ligne du différentiel décrit une correction concrète, formulée de façon lisible et colorée selon sa nature :
|
||||
|
||||
| Couleur | Signification |
|
||||
|---------|---------------|
|
||||
| **Vert** | Un ajout (un enregistrement créé) |
|
||||
| **Rouge** | Une suppression (un enregistrement retiré) |
|
||||
| **Jaune** | Une modification (un enregistrement existant modifié) |
|
||||
| **Bleu** | Un autre type de changement (par exemple un réordonnancement ou une opération propre à l'hébergeur) |
|
||||
|
||||
En bas de la fenêtre, un **résumé** récapitule le nombre d'ajouts, de suppressions et de modifications actuellement sélectionnés.
|
||||
|
||||

|
||||
|
||||
## Choisir les changements à appliquer
|
||||
|
||||
Chaque ligne du différentiel comporte une case à cocher. Par défaut, les changements sont listés pour votre relecture, et c'est vous qui décidez lesquels conserver :
|
||||
|
||||
- **Décochez** tout changement que vous ne souhaitez pas appliquer maintenant. Il reste dans votre copie de travail et réapparaîtra la prochaine fois.
|
||||
- Ne laissez cochés que les changements dont vous êtes sûr.
|
||||
|
||||
C'est utile lorsque vous avez fait plusieurs modifications sans rapport entre elles mais ne voulez en publier qu'une partie, ou lorsque vous souhaitez déployer un changement sensible séparément.
|
||||
|
||||
Le résumé et le bouton d'application se mettent à jour en direct selon votre sélection. Si rien n'est sélectionné, le bouton d'application reste désactivé.
|
||||
|
||||
## Rédiger un message de validation
|
||||
|
||||
Avant d'appliquer, saisissez un message dans le champ « Qu'est-ce qui a changé ? ». Ce message est consigné dans votre historique aux côtés des changements.
|
||||
|
||||
{{% notice style="tip" title="Décrivez l'intention, pas les adresses IP" icon="lightbulb" %}}
|
||||
Le différentiel décrit les opérations techniques, mais c'est votre message qui rendra votre historique lisible plus tard. Lorsque vous aurez besoin de revoir ce que vous avez fait, « Déplacement du courrier vers un nouvel hébergeur » est bien plus facile à comprendre que de reconstituer le sens à partir d'une liste de changements d'IP.
|
||||
{{% /notice %}}
|
||||
|
||||
## Une étape de confirmation par sécurité
|
||||
|
||||
Selon les [préférences de votre compte]({{% relref "settings" %}}), happyDomain peut afficher un écran de confirmation supplémentaire après que vous avez choisi d'appliquer :
|
||||
|
||||
- Il demande à votre hébergeur de **préparer** les corrections, puis vous montre exactement combien d'opérations l'hébergeur exécutera réellement pour votre sélection.
|
||||
- Si ce nombre diffère de ce que vous avez sélectionné (par exemple parce qu'un changement était déjà appliqué, ou parce que l'hébergeur décompose un changement en plusieurs), un avertissement s'affiche pour que vous puissiez vérifier avant de confirmer.
|
||||
|
||||
Vous pouvez configurer si cette confirmation apparaît toujours, jamais, ou uniquement lorsque les corrections préparées ne correspondent pas à votre sélection.
|
||||
|
||||
<!-- TODO: screenshot de l'écran de confirmation montrant les corrections préparées -->
|
||||
|
||||
## Après la publication
|
||||
|
||||
Une fois que vous confirmez, happyDomain envoie les changements sélectionnés à votre hébergeur et consigne l'opération, avec votre message, dans le journal du domaine. Vous pouvez ensuite consulter les déploiements passés à tout moment, et [revenir à un état antérieur]({{% relref "domain-history" %}}) si besoin.
|
||||
|
||||
Pour inspecter la zone résultante elle-même plutôt que le différentiel, ou pour en conserver une copie sous forme de fichier de zone standard, consultez la page [Importer et exporter]({{% relref "import-export" %}}).
|
||||
40
content/pages/quotas.en.md
Normal file
|
|
@ -0,0 +1,40 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Quotas & limits
|
||||
author: nemunaire
|
||||
weight: 2400
|
||||
description: "Understand the limits an administrator may set on your account, and what happens when one is reached"
|
||||
---
|
||||
|
||||
A happyDomain instance can apply **quotas** to each account. Quotas are limits set by the person running the instance (the administrator), not by you. They exist mainly to keep a shared instance fair and to avoid overloading the servers, and they apply above all to the [monitoring & checks]({{% relref "checks" %}}) system.
|
||||
|
||||
{{% notice style="info" title="Quotas are managed by the administrator" icon="circle-info" %}}
|
||||
Quotas are **read-only** for regular users. There is no screen in your account where you can view or change your own quota: they are configured server-side and adjusted only through the administration interface. If a limit is getting in your way, the right course of action is to contact the administrator of your instance.
|
||||
{{% /notice %}}
|
||||
|
||||
|
||||
## What quotas can cover
|
||||
|
||||
On a default happyDomain instance, quotas relate to how the monitoring scheduler works for your account. An administrator may set, per account or instance-wide:
|
||||
|
||||
- **Maximum checks per day**: a cap on how many checker executions are run automatically for you each day. Once the cap is reached, further scheduled checks wait until the next day.
|
||||
- **Result retention**: how long the results of your checks are kept before old executions are automatically cleaned up.
|
||||
- **Inactivity pause**: after a period without logging in, the scheduler may stop running your automatic checks until you sign in again. This keeps the instance from spending resources on abandoned accounts.
|
||||
- **Scheduling pause**: an administrator can entirely pause automatic scheduling for an account.
|
||||
|
||||
Each of these can be left at the instance default, set to a specific value for your account, or explicitly made unlimited, at the administrator's discretion.
|
||||
|
||||
{{% notice style="tip" title="No fixed limit on the number of domains" icon="lightbulb" %}}
|
||||
On a standard happyDomain instance, the quota system does not impose a built-in cap on the number of domains you can manage. If a particular instance does restrict this, it is a policy of that instance; ask its administrator for the details that apply to you.
|
||||
{{% /notice %}}
|
||||
|
||||
|
||||
## What you see when a limit is reached
|
||||
|
||||
Quotas mostly act in the background. You will not usually see a quota screen; instead you notice their effects:
|
||||
|
||||
- **Automatic checks stop running**: if your daily check cap is reached, or your account is in an inactivity or scheduling pause, scheduled checks simply do not run until the condition clears. You can still trigger a check **manually** from the [checks]({{% relref "checks#running-a-check-manually" %}}) interface.
|
||||
- **Older results disappear**: with a retention limit, executions older than the allowed age are removed during routine cleanup, so the history only goes back so far.
|
||||
- **An action is refused**: where an operation would exceed a limit, the interface shows an error message explaining what went wrong.
|
||||
|
||||
If you are unsure whether a behaviour is caused by a quota, or you need a limit raised, contact the administrator of your instance.
|
||||
39
content/pages/quotas.fr.md
Normal file
|
|
@ -0,0 +1,39 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Quotas et limites
|
||||
weight: 2400
|
||||
description: "Comprendre les limites qu'un administrateur peut appliquer à votre compte, et ce qu'il se passe lorsque l'une d'elles est atteinte"
|
||||
---
|
||||
|
||||
Une instance happyDomain peut appliquer des **quotas** à chaque compte. Les quotas sont des limites définies par la personne qui administre l'instance (l'administrateur), et non par vous. Ils servent principalement à préserver l'équité sur une instance partagée et à éviter de surcharger les serveurs ; ils concernent avant tout le système de [supervision et contrôles]({{% relref "checks" %}}).
|
||||
|
||||
{{% notice style="info" title="Les quotas sont gérés par l'administrateur" icon="circle-info" %}}
|
||||
Les quotas sont en **lecture seule** pour les utilisateurs ordinaires. Il n'existe aucun écran dans votre compte permettant de consulter ou de modifier votre propre quota : ils sont configurés côté serveur et ne sont ajustés qu'au travers de l'interface d'administration. Si une limite vous gêne, la bonne démarche consiste à contacter l'administrateur de votre instance.
|
||||
{{% /notice %}}
|
||||
|
||||
|
||||
## Ce que les quotas peuvent couvrir
|
||||
|
||||
Sur une instance happyDomain par défaut, les quotas portent sur le fonctionnement du planificateur de supervision pour votre compte. Un administrateur peut définir, par compte ou pour l'ensemble de l'instance :
|
||||
|
||||
- **Nombre maximal de contrôles par jour** : un plafond sur le nombre d'exécutions de contrôles lancées automatiquement pour vous chaque jour. Une fois ce plafond atteint, les contrôles planifiés suivants attendent le lendemain.
|
||||
- **Conservation des résultats** : la durée pendant laquelle les résultats de vos contrôles sont conservés avant que les anciennes exécutions ne soient automatiquement nettoyées.
|
||||
- **Pause pour inactivité** : après une période sans connexion, le planificateur peut cesser d'exécuter vos contrôles automatiques jusqu'à votre prochaine connexion. Cela évite que l'instance ne dépense des ressources pour des comptes abandonnés.
|
||||
- **Pause de planification** : un administrateur peut entièrement suspendre la planification automatique d'un compte.
|
||||
|
||||
Chacun de ces réglages peut rester à la valeur par défaut de l'instance, être fixé à une valeur particulière pour votre compte, ou être explicitement rendu illimité, à la discrétion de l'administrateur.
|
||||
|
||||
{{% notice style="tip" title="Pas de limite fixe sur le nombre de domaines" icon="lightbulb" %}}
|
||||
Sur une instance happyDomain standard, le système de quotas n'impose pas de plafond intégré sur le nombre de domaines que vous pouvez gérer. Si une instance particulière restreint ce point, il s'agit d'une politique propre à cette instance ; demandez à son administrateur les détails qui vous concernent.
|
||||
{{% /notice %}}
|
||||
|
||||
|
||||
## Ce que vous voyez lorsqu'une limite est atteinte
|
||||
|
||||
Les quotas agissent surtout en arrière-plan. Vous ne verrez généralement pas d'écran de quota ; vous en constatez plutôt les effets :
|
||||
|
||||
- **Les contrôles automatiques cessent de s'exécuter** : si votre plafond quotidien de contrôles est atteint, ou si votre compte est en pause pour inactivité ou de planification, les contrôles planifiés ne s'exécutent simplement plus tant que la condition persiste. Vous pouvez toujours déclencher un contrôle **manuellement** depuis l'interface des [contrôles]({{% relref "checks#lancer-une-vérification-manuellement" %}}).
|
||||
- **Les anciens résultats disparaissent** : avec une limite de conservation, les exécutions plus anciennes que la durée autorisée sont supprimées lors du nettoyage régulier, si bien que l'historique ne remonte que jusqu'à un certain point.
|
||||
- **Une action est refusée** : lorsqu'une opération dépasserait une limite, l'interface affiche un message d'erreur expliquant ce qui n'a pas fonctionné.
|
||||
|
||||
Si vous ne savez pas si un comportement est dû à un quota, ou si vous avez besoin qu'une limite soit relevée, contactez l'administrateur de votre instance.
|
||||
BIN
content/pages/services/happydomain-abstract-zone-records.webp
Normal file
|
After Width: | Height: | Size: 75 KiB |
BIN
content/pages/services/happydomain-modal-service-selector.webp
Normal file
|
After Width: | Height: | Size: 42 KiB |
86
content/pages/services/index.en.md
Normal file
|
|
@ -0,0 +1,86 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Services
|
||||
author: nemunaire
|
||||
weight: 1200
|
||||
description: "Understand how happyDomain turns raw DNS records into high-level services, and how to add one to a subdomain"
|
||||
---
|
||||
|
||||
happyDomain does not ask you to think in terms of individual DNS records. Instead, it groups the records that belong together into a single, meaningful **service**: a mailbox, a website, a delegation, a CAA policy, and so on. This is the foundation of the [abstract view]({{% relref "domain-abstract" %}}) of your zone.
|
||||
|
||||
## What is a service?
|
||||
|
||||
A service is a higher-level object that hides the complexity of one or several DNS records behind a clear, purpose-driven form.
|
||||
|
||||
For example, instead of editing a raw `MX` record, a couple of `A`/`AAAA` records and an `SPF` `TXT` record separately, you fill in a single **email** service. happyDomain takes care of generating the right records, with the right names and the right syntax.
|
||||
|
||||
Each service belongs to a family:
|
||||
|
||||
- **Services** (abstract): the recommended, human-friendly objects (email, website, CAA, delegation, ...). They map to one or more records automatically.
|
||||
- **Providers**: services tied to a specific third party that publishes its own helper (for example a hosted service that needs a predefined set of records).
|
||||
- **Raw DNS resources**: a fallback that lets you add a single record (`A`, `TXT`, `SRV`, ...) directly, when no abstract service fits your need.
|
||||
|
||||
{{% notice style="info" title="Why services instead of records?" icon="lightbulb" %}}
|
||||
Working with services means you do not have to remember the exact record types, their order, or their syntax. happyDomain validates your input and generates valid DNS for you, which greatly reduces the risk of a misconfiguration.
|
||||
{{% /notice %}}
|
||||
|
||||
## The service view of a subdomain
|
||||
|
||||
When you open a domain, each subdomain is displayed as a list of the services attached to it. A subdomain can hold several services at once: for instance the apex (`@`) of a domain often carries an email service, a website service and a CAA policy together.
|
||||
|
||||

|
||||
|
||||
From this view you can:
|
||||
|
||||
- **Add** a new service to the subdomain.
|
||||
- **Edit** an existing service to change its values.
|
||||
- **Delete** a service you no longer need.
|
||||
|
||||
All these changes are staged locally and only applied to your provider when you publish them. See the [abstract view]({{% relref "domain-abstract" %}}) for how editing and propagation work.
|
||||
|
||||
## Adding a service to a subdomain
|
||||
|
||||
To attach a new service, start from the subdomain where you want it (see [Subdomains]({{% relref "subdomains" %}}) for navigating the zone), then follow these steps.
|
||||
|
||||
### 1. Open the service selector
|
||||
|
||||
Click the **Add service** action on the subdomain. A selector opens, listing every service type you can add.
|
||||
|
||||

|
||||
|
||||
The selector is organised in tabs so you can narrow down the list:
|
||||
|
||||
- **All**: every available service type.
|
||||
- **Services**: the abstract, high-level services (recommended).
|
||||
- **Providers**: services specific to a provider.
|
||||
- **Raw DNS resources**: a single record type when you need full control.
|
||||
|
||||
You can also type in the search box at the top to filter the list by name. Pressing Enter selects the first available match.
|
||||
|
||||
{{% notice style="tip" title="Greyed-out entries" icon="circle-info" %}}
|
||||
Some service types may appear disabled. This happens when the service cannot be added in the current context: for example because your DNS provider does not support the underlying record type, or because that service already exists on this subdomain and only one instance is allowed. Hover over a disabled entry to see the reason.
|
||||
{{% /notice %}}
|
||||
|
||||
### 2. Choose the service type
|
||||
|
||||
Select the service that matches what you want to publish. happyDomain knows which record types your provider supports, so only the relevant choices are offered. To check what a given provider can handle, see the [Provider features]({{% relref "provider-features" %}}) page.
|
||||
|
||||
### 3. Fill in the service form
|
||||
|
||||
happyDomain then presents a form tailored to the chosen service. Each field corresponds to a meaningful piece of information (a target host, a priority, a public key, a policy value, ...) rather than to raw record syntax.
|
||||
|
||||
<!-- TODO: screenshot of a service edit form -->
|
||||
|
||||
Fill in the fields, then confirm to add the service to the subdomain.
|
||||
|
||||
### 4. Review the generated records
|
||||
|
||||
Once the form is validated, happyDomain converts your input into the corresponding DNS records and adds them to the staged zone. You can review them in the [abstract view]({{% relref "domain-abstract" %}}) before publishing your changes to your provider.
|
||||
|
||||
## Trying services without an account
|
||||
|
||||
happyDomain also offers a public **record generator** where you can build and preview the DNS records produced by a service without signing in. Pick a service type, enter a domain name, fill in the form, and the generated zone-file entries are displayed instantly.
|
||||
|
||||
This is a handy way to discover how a given service maps to actual DNS records, or to grab a record you will paste elsewhere.
|
||||
|
||||
<!-- TODO: screenshot of the public record generator -->
|
||||
85
content/pages/services/index.fr.md
Normal file
|
|
@ -0,0 +1,85 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Services
|
||||
weight: 1200
|
||||
description: "Comprendre comment happyDomain transforme les enregistrements DNS bruts en services de haut niveau, et comment en ajouter un à un sous-domaine"
|
||||
---
|
||||
|
||||
happyDomain ne vous demande pas de raisonner en termes d'enregistrements DNS individuels. À la place, il regroupe les enregistrements qui vont ensemble au sein d'un unique **service** porteur de sens : une messagerie, un site web, une délégation, une politique CAA, etc. C'est le fondement de la [vue abstraite]({{% relref "domain-abstract" %}}) de votre zone.
|
||||
|
||||
## Qu'est-ce qu'un service ?
|
||||
|
||||
Un service est un objet de plus haut niveau qui masque la complexité d'un ou de plusieurs enregistrements DNS derrière un formulaire clair, orienté usage.
|
||||
|
||||
Par exemple, au lieu d'éditer séparément un enregistrement `MX`, quelques enregistrements `A`/`AAAA` et un enregistrement `SPF` de type `TXT`, vous remplissez un seul service **messagerie**. happyDomain se charge de générer les bons enregistrements, avec les bons noms et la bonne syntaxe.
|
||||
|
||||
Chaque service appartient à une famille :
|
||||
|
||||
- **Services** (abstraits) : les objets recommandés, pensés pour les humains (messagerie, site web, CAA, délégation, etc.). Ils se traduisent automatiquement en un ou plusieurs enregistrements.
|
||||
- **Fournisseurs** : des services liés à un acteur tiers précis qui publie son propre assistant (par exemple un service hébergé nécessitant un ensemble d'enregistrements prédéfini).
|
||||
- **Ressources DNS brutes** : une solution de repli qui vous permet d'ajouter directement un enregistrement unique (`A`, `TXT`, `SRV`, etc.), lorsqu'aucun service abstrait ne correspond à votre besoin.
|
||||
|
||||
{{% notice style="info" title="Pourquoi des services plutôt que des enregistrements ?" icon="lightbulb" %}}
|
||||
Travailler avec des services vous évite d'avoir à mémoriser les types d'enregistrements exacts, leur ordre ou leur syntaxe. happyDomain valide votre saisie et génère du DNS correct à votre place, ce qui réduit fortement le risque d'erreur de configuration.
|
||||
{{% /notice %}}
|
||||
|
||||
## La vue par services d'un sous-domaine
|
||||
|
||||
Lorsque vous ouvrez un domaine, chaque sous-domaine est présenté sous la forme d'une liste des services qui lui sont rattachés. Un sous-domaine peut accueillir plusieurs services à la fois : par exemple, la racine (`@`) d'un domaine porte souvent à la fois un service de messagerie, un service de site web et une politique CAA.
|
||||
|
||||

|
||||
|
||||
Depuis cette vue, vous pouvez :
|
||||
|
||||
- **Ajouter** un nouveau service au sous-domaine ;
|
||||
- **Modifier** un service existant pour en changer les valeurs ;
|
||||
- **Supprimer** un service dont vous n'avez plus besoin.
|
||||
|
||||
Toutes ces modifications sont préparées localement et ne sont appliquées chez votre hébergeur qu'au moment de leur publication. Consultez la [vue abstraite]({{% relref "domain-abstract" %}}) pour comprendre le fonctionnement de l'édition et de la propagation.
|
||||
|
||||
## Ajouter un service à un sous-domaine
|
||||
|
||||
Pour rattacher un nouveau service, placez-vous sur le sous-domaine où vous le souhaitez (voir [Sous-domaines]({{% relref "subdomains" %}}) pour naviguer dans la zone), puis suivez ces étapes.
|
||||
|
||||
### 1. Ouvrir le sélecteur de services
|
||||
|
||||
Cliquez sur l'action **Ajouter un service** du sous-domaine. Un sélecteur s'ouvre, listant tous les types de services que vous pouvez ajouter.
|
||||
|
||||

|
||||
|
||||
Le sélecteur est organisé en onglets pour vous aider à restreindre la liste :
|
||||
|
||||
- **Tous** : tous les types de services disponibles.
|
||||
- **Services** : les services abstraits de haut niveau (recommandé).
|
||||
- **Fournisseurs** : les services spécifiques à un fournisseur.
|
||||
- **Ressources DNS brutes** : un type d'enregistrement unique, lorsque vous avez besoin d'un contrôle total.
|
||||
|
||||
Vous pouvez également saisir un terme dans le champ de recherche, en haut, pour filtrer la liste par nom. Appuyer sur Entrée sélectionne le premier résultat disponible.
|
||||
|
||||
{{% notice style="tip" title="Entrées grisées" icon="circle-info" %}}
|
||||
Certains types de services peuvent apparaître désactivés. Cela se produit lorsque le service ne peut pas être ajouté dans le contexte actuel : par exemple parce que votre hébergeur DNS ne prend pas en charge le type d'enregistrement sous-jacent, ou parce que ce service existe déjà sur ce sous-domaine et qu'une seule instance est autorisée. Survolez une entrée désactivée pour en connaître la raison.
|
||||
{{% /notice %}}
|
||||
|
||||
### 2. Choisir le type de service
|
||||
|
||||
Sélectionnez le service correspondant à ce que vous souhaitez publier. happyDomain connaît les types d'enregistrements pris en charge par votre hébergeur : seuls les choix pertinents vous sont donc proposés. Pour savoir ce qu'un hébergeur donné sait gérer, consultez la page [Fonctionnalités des fournisseurs]({{% relref "provider-features" %}}).
|
||||
|
||||
### 3. Remplir le formulaire du service
|
||||
|
||||
happyDomain présente alors un formulaire adapté au service choisi. Chaque champ correspond à une information porteuse de sens (un hôte cible, une priorité, une clé publique, une valeur de politique, etc.) plutôt qu'à de la syntaxe d'enregistrement brute.
|
||||
|
||||
<!-- TODO: capture d'écran d'un formulaire d'édition de service -->
|
||||
|
||||
Renseignez les champs, puis validez pour ajouter le service au sous-domaine.
|
||||
|
||||
### 4. Vérifier les enregistrements générés
|
||||
|
||||
Une fois le formulaire validé, happyDomain convertit votre saisie en enregistrements DNS correspondants et les ajoute à la zone en préparation. Vous pouvez les vérifier dans la [vue abstraite]({{% relref "domain-abstract" %}}) avant de publier vos modifications chez votre hébergeur.
|
||||
|
||||
## Essayer les services sans compte
|
||||
|
||||
happyDomain propose également un **générateur d'enregistrements** public qui vous permet de construire et de prévisualiser les enregistrements DNS produits par un service sans être connecté. Choisissez un type de service, saisissez un nom de domaine, remplissez le formulaire : les entrées de fichier de zone générées s'affichent instantanément.
|
||||
|
||||
C'est un moyen pratique de découvrir comment un service donné se traduit en véritables enregistrements DNS, ou de récupérer un enregistrement à coller ailleurs.
|
||||
|
||||
<!-- TODO: capture d'écran du générateur d'enregistrements public -->
|
||||
76
content/pages/settings.en.md
Normal file
|
|
@ -0,0 +1,76 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Your account and settings
|
||||
author: nemunaire
|
||||
weight: 2000
|
||||
description: "Manage your happyDomain account and tailor the interface: language, field hints, confirmation, zone view, password and account deletion"
|
||||
aliases:
|
||||
me
|
||||
---
|
||||
|
||||
happyDomain lets you manage your account and tailor how the interface behaves. Your preferences are saved with your account, so you find them again on every device you connect from.
|
||||
|
||||
You reach this page from the **My Account** link in the top menu. Each option is described below.
|
||||
|
||||
<!-- TODO: screenshot of the settings form -->
|
||||
|
||||
## Language
|
||||
|
||||
Choose the language used throughout the interface. The list contains every language currently available in your happyDomain instance. Changing it takes effect as soon as you save.
|
||||
|
||||
## Field hints
|
||||
|
||||
Form fields often come with a short help text. This setting controls how that help is displayed:
|
||||
|
||||
- **Hide** -- no help text is shown.
|
||||
- **Tooltip near field** -- the help appears as a tooltip when you hover the field.
|
||||
- **Under field when focused** -- the help appears below the field, but only while you are editing it.
|
||||
- **Under field, always** -- the help is permanently displayed below each field.
|
||||
|
||||
Pick the level of guidance that suits your familiarity with DNS.
|
||||
|
||||
## Confirmation before applying
|
||||
|
||||
When you publish changes to your DNS provider, happyDomain can show a confirmation step beforehand. This setting decides when:
|
||||
|
||||
- **Ask on unexpected differences** -- the confirmation appears only when the changes differ from what was expected.
|
||||
- **Always ask** -- a confirmation is always shown before applying.
|
||||
- **Never ask, overwrite on publish** -- changes are applied directly, without a confirmation step.
|
||||
|
||||
See [Publishing changes]({{% relref "publish-changes" %}}) for the full publication workflow.
|
||||
|
||||
## Zone view layout
|
||||
|
||||
Choose how a domain's zone is displayed:
|
||||
|
||||
- **Grid view (easiest)** -- the most visual and approachable layout.
|
||||
- **List view (fastest)** -- a compact list, quicker to scan.
|
||||
- **List with records (advanced)** -- a list that also exposes the underlying DNS records, for advanced users.
|
||||
|
||||
## Show DNS record types
|
||||
|
||||
This switch shows the resource record type (A, MX, CNAME, etc.) associated with each service. It is meant for users who are already familiar with DNS and want to see the technical record types behind the friendly service names.
|
||||
|
||||
## Newsletter
|
||||
|
||||
The option to receive news about future improvements is proposed when you [create your account]({{% relref "signup" %}}). To change your subscription afterwards, refer to the unsubscribe link included in the messages you receive.
|
||||
|
||||
## Saving
|
||||
|
||||
When your preferences are set, click **Save settings**. A confirmation message appears and the new settings take effect immediately, including a language change if you made one.
|
||||
|
||||
## Change password
|
||||
|
||||
A dedicated part of the page lets you change the password of your account.
|
||||
|
||||
## Change account email address
|
||||
|
||||
It is currently not possible to change the email address of your account. We invite you to contact us if you wish to change it.
|
||||
|
||||
## Delete your account
|
||||
|
||||
The last part of the page allows you to delete your happyDomain account.
|
||||
|
||||
Once the deletion is validated, your account will no longer be accessible and all data belonging to you will be deleted shortly after, during a regular database cleanup.
|
||||
|
||||
From the moment you delete your account, your domains will continue to respond according to the last update you made on happyDomain. The deletion will not affect the distributed data.
|
||||
75
content/pages/settings.fr.md
Normal file
|
|
@ -0,0 +1,75 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Votre compte et vos réglages
|
||||
weight: 2000
|
||||
description: "Gérez votre compte happyDomain et personnalisez l'interface : langue, aide des champs, confirmation, affichage des zones, mot de passe et suppression du compte"
|
||||
aliases:
|
||||
me
|
||||
---
|
||||
|
||||
happyDomain vous permet de gérer votre compte et d'ajuster le comportement de l'interface. Vos préférences sont enregistrées avec votre compte ; vous les retrouvez ainsi sur chaque appareil depuis lequel vous vous connectez.
|
||||
|
||||
Vous accédez à cette page en cliquant sur le lien « Mon compte » dans le menu en haut. Chaque option est décrite ci-dessous.
|
||||
|
||||
<!-- TODO: screenshot of the settings form -->
|
||||
|
||||
## Langue
|
||||
|
||||
Choisissez la langue utilisée dans toute l'interface. La liste contient toutes les langues actuellement disponibles sur votre instance happyDomain. Le changement prend effet dès l'enregistrement.
|
||||
|
||||
## Aide des champs
|
||||
|
||||
Les champs des formulaires sont souvent accompagnés d'un court texte d'aide. Ce réglage détermine la façon dont cette aide s'affiche :
|
||||
|
||||
- **Masquer** : aucun texte d'aide n'est affiché.
|
||||
- **Infobulle près du champ** : l'aide apparaît sous forme d'infobulle au survol du champ.
|
||||
- **Sous le champ lors de la saisie** : l'aide apparaît sous le champ, mais uniquement pendant que vous le modifiez.
|
||||
- **Sous le champ, en permanence** : l'aide reste affichée sous chaque champ.
|
||||
|
||||
Choisissez le niveau d'accompagnement adapté à votre aisance avec le DNS.
|
||||
|
||||
## Confirmation avant application
|
||||
|
||||
Lorsque vous publiez des modifications chez votre fournisseur DNS, happyDomain peut afficher une étape de confirmation au préalable. Ce réglage décide du moment :
|
||||
|
||||
- **Demander en cas de différences inattendues** : la confirmation n'apparaît que lorsque les modifications diffèrent de ce qui était attendu.
|
||||
- **Toujours demander** : une confirmation est systématiquement affichée avant l'application.
|
||||
- **Ne jamais demander, écraser à la publication** : les modifications sont appliquées directement, sans étape de confirmation.
|
||||
|
||||
Consultez [Publier ses modifications]({{% relref "publish-changes" %}}) pour le déroulé complet de la publication.
|
||||
|
||||
## Affichage des zones
|
||||
|
||||
Choisissez la façon dont la zone d'un domaine est présentée :
|
||||
|
||||
- **Vue en grille (le plus simple)** : la présentation la plus visuelle et la plus accessible.
|
||||
- **Vue en liste (le plus rapide)** : une liste compacte, plus rapide à parcourir.
|
||||
- **Liste avec enregistrements (avancé)** : une liste qui expose également les enregistrements DNS sous-jacents, pour les utilisateurs avancés.
|
||||
|
||||
## Afficher les types d'enregistrements DNS
|
||||
|
||||
Cet interrupteur affiche le type d'enregistrement (A, MX, CNAME, etc.) associé à chaque service. Il s'adresse aux personnes déjà familières du DNS qui souhaitent voir les types techniques derrière les noms de services simplifiés.
|
||||
|
||||
## Lettre d'information
|
||||
|
||||
L'option permettant de recevoir les nouvelles des prochaines améliorations vous est proposée lors de la [création de votre compte]({{% relref "signup" %}}). Pour modifier ensuite votre abonnement, référez-vous au lien de désinscription présent dans les messages que vous recevez.
|
||||
|
||||
## Enregistrement
|
||||
|
||||
Une fois vos préférences définies, cliquez sur « Enregistrer les réglages ». Un message de confirmation apparaît et les nouveaux réglages prennent effet immédiatement, y compris un changement de langue si vous en avez effectué un.
|
||||
|
||||
## Changer de mot de passe
|
||||
|
||||
Une partie dédiée de la page vous permet de changer le mot de passe de votre compte.
|
||||
|
||||
## Changer l'adresse électronique de compte
|
||||
|
||||
Il n'est pour l'instant pas possible de changer l'adresse électronique de votre compte. Nous vous invitons à nous contacter si vous souhaitez la changer.
|
||||
|
||||
## Supprimer son compte
|
||||
|
||||
La dernière partie de la page vous permet de supprimer votre compte happyDomain.
|
||||
|
||||
Une fois la suppression validée, votre compte ne sera plus accessible et l'ensemble des données vous appartenant sera supprimé peu de temps après, lors d'un nettoyage régulier de la base de données.
|
||||
|
||||
À partir du moment où vous supprimez votre compte, vos domaines continueront de répondre selon la dernière mise à jour que vous avez effectué sur happyDomain. La suppression n'affectera pas les données distribuées.
|
||||
44
content/pages/signup.en.md
Normal file
|
|
@ -0,0 +1,44 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Create an account
|
||||
author: nemunaire
|
||||
weight: 100
|
||||
description: "Sign up for a happyDomain account and validate your email address"
|
||||
---
|
||||
|
||||
Before you can manage your domains, you need a happyDomain account. Creating one takes less than two minutes and only requires an email address and a password.
|
||||
|
||||
## Filling in the sign-up form
|
||||
|
||||
From the home page, follow the link to register, then fill in the form:
|
||||
|
||||
<!-- TODO: screenshot of the sign-up form -->
|
||||
|
||||
- **Email address** -- this address identifies you on the platform and is used to contact you for security-related operations (password recovery, important notices). It must contain a valid `@`.
|
||||
- **Password** -- choose a strong password (see below).
|
||||
- **Password confirmation** -- retype the exact same password to avoid typos.
|
||||
- **Keep me informed of future big improvements** -- an optional checkbox to subscribe to the project newsletter. Leave it unchecked if you do not wish to receive these updates.
|
||||
|
||||
The interface language you are currently using is automatically recorded with your account, so the emails you receive will be in that language.
|
||||
|
||||
{{% notice style="tip" title="Password requirements" icon="key" %}}
|
||||
A password is accepted only if it contains at least 8 characters, including at least one uppercase letter, one lowercase letter and one digit. It must also contain a special character, or be at least 11 characters long.
|
||||
{{% /notice %}}
|
||||
|
||||
Some servers display an anti-bot challenge (captcha) below the form. If so, complete it before submitting.
|
||||
|
||||
When everything is filled in correctly, click **Sign up!**.
|
||||
|
||||
## Validating your email address
|
||||
|
||||
On most servers, an email is sent to the address you provided right after registration. Open your mailbox and click the validation link it contains to activate your account.
|
||||
|
||||
<!-- TODO: screenshot of the email validation page -->
|
||||
|
||||
If you did not receive the message (check your spam folder first), you can request a new one from the email validation page by entering your address again and clicking **Send again**.
|
||||
|
||||
{{% notice style="info" title="Servers without email" icon="circle-info" %}}
|
||||
Some happyDomain instances run without an email service. On these servers, no validation message is sent: your account is usable immediately and you can [log in]({{% relref "login" %}}) right away.
|
||||
{{% /notice %}}
|
||||
|
||||
Once your address is validated, you are redirected to the [login page]({{% relref "login" %}}) where you can sign in with your new credentials.
|
||||
43
content/pages/signup.fr.md
Normal file
|
|
@ -0,0 +1,43 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Créer un compte
|
||||
weight: 100
|
||||
description: "Inscrivez-vous sur happyDomain et validez votre adresse e-mail"
|
||||
---
|
||||
|
||||
Avant de pouvoir gérer vos domaines, il vous faut un compte happyDomain. Sa création prend moins de deux minutes et ne demande qu'une adresse e-mail et un mot de passe.
|
||||
|
||||
## Remplir le formulaire d'inscription
|
||||
|
||||
Depuis la page d'accueil, suivez le lien d'inscription, puis remplissez le formulaire :
|
||||
|
||||
<!-- TODO: screenshot of the sign-up form -->
|
||||
|
||||
- **Adresse e-mail** : cette adresse vous identifie sur la plateforme et sert à vous contacter pour les opérations liées à la sécurité (récupération de mot de passe, informations importantes). Elle doit contenir un `@` valide.
|
||||
- **Mot de passe** : choisissez un mot de passe robuste (voir ci-dessous).
|
||||
- **Confirmation du mot de passe** : ressaisissez exactement le même mot de passe afin d'éviter toute faute de frappe.
|
||||
- **Tenez-moi informé des prochaines grandes améliorations** : une case à cocher facultative pour vous abonner à la lettre d'information du projet. Laissez-la décochée si vous ne souhaitez pas recevoir ces nouvelles.
|
||||
|
||||
La langue de l'interface que vous utilisez est automatiquement enregistrée avec votre compte ; les e-mails que vous recevrez seront ainsi dans cette langue.
|
||||
|
||||
{{% notice style="tip" title="Exigences du mot de passe" icon="key" %}}
|
||||
Un mot de passe n'est accepté que s'il contient au moins 8 caractères, dont au moins une majuscule, une minuscule et un chiffre. Il doit en outre contenir un caractère spécial, ou bien faire au moins 11 caractères.
|
||||
{{% /notice %}}
|
||||
|
||||
Certains serveurs affichent une vérification anti-robot (captcha) sous le formulaire. Le cas échéant, complétez-la avant de valider.
|
||||
|
||||
Lorsque tout est correctement renseigné, cliquez sur « Inscrivez-vous ! ».
|
||||
|
||||
## Valider votre adresse e-mail
|
||||
|
||||
Sur la plupart des serveurs, un e-mail est envoyé à l'adresse indiquée juste après l'inscription. Ouvrez votre messagerie et cliquez sur le lien de validation qu'il contient pour activer votre compte.
|
||||
|
||||
<!-- TODO: screenshot of the email validation page -->
|
||||
|
||||
Si vous n'avez pas reçu le message (vérifiez d'abord votre dossier de courrier indésirable), vous pouvez en demander un nouveau depuis la page de validation : saisissez à nouveau votre adresse, puis cliquez sur « Renvoyer ».
|
||||
|
||||
{{% notice style="info" title="Serveurs sans e-mail" icon="circle-info" %}}
|
||||
Certaines instances happyDomain fonctionnent sans service de messagerie. Sur ces serveurs, aucun message de validation n'est envoyé : votre compte est utilisable immédiatement et vous pouvez [vous connecter]({{% relref "login" %}}) sans attendre.
|
||||
{{% /notice %}}
|
||||
|
||||
Une fois votre adresse validée, vous êtes redirigé vers la [page de connexion]({{% relref "login" %}}) où vous pourrez vous identifier avec vos nouveaux identifiants.
|
||||
BIN
content/pages/subdomains/happydomain-abstract-zone-records.webp
Normal file
|
After Width: | Height: | Size: 75 KiB |
BIN
content/pages/subdomains/happydomain-modal-new-subdomain.webp
Normal file
|
After Width: | Height: | Size: 8.1 KiB |
66
content/pages/subdomains/index.en.md
Normal file
|
|
@ -0,0 +1,66 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Subdomains
|
||||
author: nemunaire
|
||||
weight: 1100
|
||||
description: "Navigate and manage the subdomains of a domain: the subdomain list, the tree view, and how to create a new subdomain path"
|
||||
---
|
||||
|
||||
A domain is rarely flat: it is made of a root (the apex, written `@`) and a hierarchy of subdomains such as `www`, `mail`, or `blog.staging`. happyDomain presents this hierarchy in a clear, navigable way so you can quickly find and manage each part of your zone.
|
||||
|
||||
## The subdomain list
|
||||
|
||||
When you open a domain, the left sidebar shows the list of subdomains for the currently selected zone version. Each entry is displayed as a path relative to the domain, with the apex shown as the domain name itself.
|
||||
|
||||

|
||||
|
||||
The list behaves like a table of contents:
|
||||
|
||||
- It is **indented** to reflect the hierarchy: a subdomain is shifted to the right according to its depth in the tree, so `blog.staging` appears nested under `staging`.
|
||||
- Clicking an entry **scrolls** the main panel to the corresponding subdomain.
|
||||
- As you scroll through the zone, the sidebar **highlights** the subdomain you are currently looking at and follows along automatically.
|
||||
|
||||
Intermediate levels that do not carry any service of their own are still shown, so the tree remains coherent and easy to read. (For reverse zones, only the actual entries are listed.)
|
||||
|
||||
## Managing a subdomain
|
||||
|
||||
Each subdomain in the main panel groups the [services]({{% relref "services" %}}) attached to it. From there you can add, edit, or remove services. Adding a service to an existing subdomain is covered in detail in [Services]({{% relref "services#adding-a-service-to-a-subdomain" %}}).
|
||||
|
||||
## Creating a new subdomain path
|
||||
|
||||
To create a brand-new subdomain (one that does not exist yet in your zone), use the **Add a subdomain** action at the top of the sidebar.
|
||||
|
||||
<!-- TODO: screenshot of the Add a subdomain button -->
|
||||
|
||||
### 1. Enter the subdomain name
|
||||
|
||||
A dialog opens asking for the new subdomain to create under your domain. Type the name **relative to the domain**: for example, enter `www` to create `www.example.com`, or `blog.staging` to create a nested path in one step.
|
||||
|
||||

|
||||
|
||||
The name is validated as you type. You only need to provide the part to the left of your domain name; happyDomain appends the domain for you.
|
||||
|
||||
{{% notice style="tip" title="Apex and nested paths" icon="sitemap" %}}
|
||||
Leave the field empty (or use `@`) to target the domain apex itself. You can also create several levels at once by typing a dotted path such as `a.b.c`: the intermediate levels are created as needed.
|
||||
{{% /notice %}}
|
||||
|
||||
### 2. Add a first service
|
||||
|
||||
Creating a subdomain only makes sense if it carries at least one service, so happyDomain chains directly into the service selector once you confirm the name. Pick the service type and fill in its form exactly as described in [Services]({{% relref "services" %}}).
|
||||
|
||||
The new subdomain then appears in the sidebar and in the main panel, with the service you just added.
|
||||
|
||||
{{% notice style="info" title="Changes are staged" icon="circle-info" %}}
|
||||
Creating a subdomain and its service does not contact your DNS provider immediately. Like every other change, it is staged locally and only sent to your provider when you publish the zone. See the [abstract view]({{% relref "domain-abstract" %}}) for how to review and apply your changes.
|
||||
{{% /notice %}}
|
||||
|
||||
## Other domain actions
|
||||
|
||||
Next to the **Add a subdomain** button, a menu gives access to domain-wide actions, including:
|
||||
|
||||
- viewing the [history]({{% relref "domain-history" %}}) of zone versions;
|
||||
- consulting the audit log of changes;
|
||||
- configuring [checks]({{% relref "checks" %}}) for the domain;
|
||||
- running a WHOIS lookup;
|
||||
- viewing or re-importing the zone, or uploading a zone file;
|
||||
- removing the domain from happyDomain.
|
||||
65
content/pages/subdomains/index.fr.md
Normal file
|
|
@ -0,0 +1,65 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Sous-domaines
|
||||
weight: 1100
|
||||
description: "Naviguer et gérer les sous-domaines d'un domaine : la liste des sous-domaines, la vue en arbre et la création d'un nouveau sous-domaine"
|
||||
---
|
||||
|
||||
Un domaine est rarement plat : il se compose d'une racine (l'apex, noté `@`) et d'une hiérarchie de sous-domaines tels que `www`, `mail` ou `blog.staging`. happyDomain présente cette hiérarchie de façon claire et navigable, afin que vous puissiez retrouver et gérer rapidement chaque partie de votre zone.
|
||||
|
||||
## La liste des sous-domaines
|
||||
|
||||
Lorsque vous ouvrez un domaine, la barre latérale de gauche affiche la liste des sous-domaines pour la version de zone sélectionnée. Chaque entrée est présentée sous la forme d'un chemin relatif au domaine, l'apex étant affiché sous la forme du nom de domaine lui-même.
|
||||
|
||||

|
||||
|
||||
Cette liste se comporte comme une table des matières :
|
||||
|
||||
- elle est **indentée** pour refléter la hiérarchie : un sous-domaine est décalé vers la droite en fonction de sa profondeur dans l'arbre, si bien que `blog.staging` apparaît imbriqué sous `staging` ;
|
||||
- cliquer sur une entrée **fait défiler** le panneau principal jusqu'au sous-domaine correspondant ;
|
||||
- au fil de votre défilement dans la zone, la barre latérale **met en évidence** le sous-domaine que vous consultez et suit automatiquement votre position.
|
||||
|
||||
Les niveaux intermédiaires qui ne portent aucun service propre restent affichés, de sorte que l'arbre demeure cohérent et facile à lire. (Pour les zones inverses, seules les entrées réelles sont listées.)
|
||||
|
||||
## Gérer un sous-domaine
|
||||
|
||||
Dans le panneau principal, chaque sous-domaine regroupe les [services]({{% relref "services" %}}) qui lui sont rattachés. Vous pouvez y ajouter, modifier ou supprimer des services. L'ajout d'un service à un sous-domaine existant est détaillé dans la page [Services]({{% relref "services#ajouter-un-service-à-un-sous-domaine" %}}).
|
||||
|
||||
## Créer un nouveau sous-domaine
|
||||
|
||||
Pour créer un sous-domaine entièrement nouveau (qui n'existe pas encore dans votre zone), utilisez l'action **Ajouter un sous-domaine**, en haut de la barre latérale.
|
||||
|
||||
<!-- TODO: capture d'écran du bouton « Ajouter un sous-domaine » -->
|
||||
|
||||
### 1. Saisir le nom du sous-domaine
|
||||
|
||||
Une fenêtre s'ouvre et vous demande le nouveau sous-domaine à créer sous votre domaine. Saisissez le nom **relatif au domaine** : par exemple, entrez `www` pour créer `www.example.com`, ou `blog.staging` pour créer un chemin imbriqué en une seule fois.
|
||||
|
||||

|
||||
|
||||
Le nom est validé au fur et à mesure de la saisie. Vous n'avez besoin de fournir que la partie située à gauche de votre nom de domaine ; happyDomain ajoute le domaine pour vous.
|
||||
|
||||
{{% notice style="tip" title="Apex et chemins imbriqués" icon="sitemap" %}}
|
||||
Laissez le champ vide (ou utilisez `@`) pour viser la racine du domaine elle-même. Vous pouvez aussi créer plusieurs niveaux d'un coup en saisissant un chemin avec des points, comme `a.b.c` : les niveaux intermédiaires sont créés au besoin.
|
||||
{{% /notice %}}
|
||||
|
||||
### 2. Ajouter un premier service
|
||||
|
||||
Créer un sous-domaine n'a de sens que s'il porte au moins un service : happyDomain enchaîne donc directement avec le sélecteur de services dès que vous confirmez le nom. Choisissez le type de service et remplissez son formulaire exactement comme décrit dans la page [Services]({{% relref "services" %}}).
|
||||
|
||||
Le nouveau sous-domaine apparaît alors dans la barre latérale et dans le panneau principal, avec le service que vous venez d'ajouter.
|
||||
|
||||
{{% notice style="info" title="Les modifications sont préparées" icon="circle-info" %}}
|
||||
Créer un sous-domaine et son service ne contacte pas immédiatement votre hébergeur DNS. Comme toute autre modification, l'opération est préparée localement et n'est envoyée à votre hébergeur qu'au moment de la publication de la zone. Consultez la [vue abstraite]({{% relref "domain-abstract" %}}) pour savoir comment vérifier et appliquer vos modifications.
|
||||
{{% /notice %}}
|
||||
|
||||
## Autres actions sur le domaine
|
||||
|
||||
À côté du bouton **Ajouter un sous-domaine**, un menu donne accès aux actions concernant l'ensemble du domaine, notamment :
|
||||
|
||||
- consulter l'[historique]({{% relref "domain-history" %}}) des versions de la zone ;
|
||||
- consulter le journal d'audit des modifications ;
|
||||
- configurer les [vérifications]({{% relref "checks" %}}) du domaine ;
|
||||
- effectuer une recherche WHOIS ;
|
||||
- afficher ou réimporter la zone, ou téléverser un fichier de zone ;
|
||||
- retirer le domaine de happyDomain.
|
||||
|
|
@ -2,7 +2,7 @@
|
|||
date: 2021-01-12T21:38:49+02:00
|
||||
author: Frederic
|
||||
title: Test a domain
|
||||
weight: 50
|
||||
weight: 1900
|
||||
---
|
||||
|
||||
Please, help us to write this Documentation page
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
---
|
||||
date: 2020-12-10T10:26:54+01:00
|
||||
title: Tester un domaine
|
||||
weight: 50
|
||||
weight: 1900
|
||||
---
|
||||
|
||||
Documentation à faire
|
||||
|
|
|
|||