---
gitea: none
include_toc: true
---

# znc

## Synopsis

ZNC, a bouncer IRC.

[For more informations](https://wiki.znc.in/)

## Basic variables

#### IRC Bouncer ZNC (*general.znc*)

| Description                                                                           | Example         | Type                                                                                                                       |
|---------------------------------------------------------------------------------------|-----------------|----------------------------------------------------------------------------------------------------------------------------|
| **Nom de domaine externe de ZNC** (*[external_domain_name](dictionaries/40_znc.xml)*) | irc.example.net | [domainname](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) |
| **Utilisateur IRC et ZNC** (*[user_name](dictionaries/40_znc.xml)*)                   | jdoe            | [unix_user](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable)  |
| **Mot de passe de l'utilisateur ZNC** (*[user_password](dictionaries/40_znc.xml)*)    | JD0eP@ss        | [password](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable)   |
| **Nom d'utilisateur réel** (*[real_name](dictionaries/40_znc.xml)*)                   | John Doe        | [string](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable)     |

##### Serveurs IRC (*general.znc.servers*)

This a family is a leadership.

| Description                                                                                  | Example   | Type                                                                                                                     |
|----------------------------------------------------------------------------------------------|-----------|--------------------------------------------------------------------------------------------------------------------------|
| **Mot de passe de l'utilisateur sur le serveur IRC** (*[password](dictionaries/40_znc.xml)*) | p@ssw0rd  | [password](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) |
| **Nom des salons du serveur IRC** (*[channels](dictionaries/40_znc.xml)*) [+]                | example   | [string](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable)   |


- [+]: variable is multiple
- **bold**: variable is mandatory

## Variables

#### systemd-journald (*general.journald*)

| Description                                                        | Type                                                                                                                       | Supplier      | Values       |
|--------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------|---------------|--------------|
| *[journal_client_server_domainname](dictionaries/20_journald.xml)* | [domainname](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Journald      |              |
| *[journal_host_name](dictionaries/20_journald.xml)*                | [domainname](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Journald:host | <calculated> |

#### IRC Bouncer ZNC (*general.znc*)

| Description                                                                                                              | Type                                                                                                                   | Values    | Choices                    |
|--------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------|-----------|----------------------------|
| **Autorité de certification signant le certificat du domaine extérieur** (*[znc_crt_provider](dictionaries/40_znc.xml)*) | [choice](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | autosigne | autosigne<br />letsencrypt |


- [+]: variable is multiple
- **bold**: variable is mandatory

## Variables for expert

##### Serveurs IRC (*general.znc.servers*)

This a family is a leadership.

| Description                                                                | Example      | Type                                                                                                                       |
|----------------------------------------------------------------------------|--------------|----------------------------------------------------------------------------------------------------------------------------|
| **Adresse du serveur IRC** (*[server_names](dictionaries/40_znc.xml)*) [+] | irc.oftc.net | [domainname](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) |


- [+]: variable is multiple
- **bold**: variable is mandatory

## Examples

Zone names are provided as examples. Think about adapting with the value of provider_zone in configuration file.

With minimum providers:

```
znc:
  applicationservice: znc
  zones_name:
    - localdns
  values:
    general.znc.external_domain_name: irc.example.net
    general.znc.user_name: jdoe
    general.znc.user_password: JD0eP@ss
    general.znc.real_name: John Doe
    general.znc.servers.server_names:
      - irc.oftc.net
    general.znc.servers.password:
      '0': p@ssw0rd
    general.znc.servers.channels:
      '0': example
```

With all providers:

```
znc:
  applicationservice: znc
  zones_name:
    - journald
    - externaldns
    - localdns
  values:
    general.znc.external_domain_name: irc.example.net
    general.znc.user_name: jdoe
    general.znc.user_password: JD0eP@ss
    general.znc.real_name: John Doe
    general.znc.servers.server_names:
      - irc.oftc.net
    general.znc.servers.password:
      '0': p@ssw0rd
    general.znc.servers.channels:
      '0': example
```

## Dependances

- [base-fedora-36](../base-fedora-36/README.md)
  - [base-fedora](../base-fedora/README.md)
    - [systemd](../systemd/README.md)
      - [base-machine](../base-machine/README.md)
        - [base](../base/README.md)
        - [dns-local](../dns-local/README.md)
        - [pki-tls](../pki-tls/README.md)
      - [journald](../journald/README.md)
      - [resolved](../resolved/README.md)
- [dns-external](../dns-external/README.md)

[All applications services for this dataset.](../README.md)