Error rendering macro 'rw-search'

null

Downloads

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Example server address idna-apps.acme.com; idna is not allowed

...

Code Block
languagetext
=====================================================================
 Server address - please read
=====================================================================
 Users open iDNA Applications and Metabase in their browser under
 this address. Links in Metabase e-mails and subscriptions and in
 iDNA alert e-mails use it too. If users' browsers cannot reach it,
 these links break. (This does not rename the server.)
 You can change it later with 'ifa hostname'.

 This server's host name: idna-apps (no domain)

   1) idna-apps.exampleacme.com     points to this server (recommended)
   2) 10.20.30.40            IP address of eth0; links break if it changes
   3) idna-apps              short name; works only if users' DNS completes it
   4) idna-apps.localdomain  not found in DNS
   Or enter a custom host name, e.g. a DNS alias your users already know.

Select an option or enter a custom host name [1]:

...

  • points to this server: DNS resolves the name to this host. Choose such a name.
  • IP address of …; links break if it changes: works without DNS, but every link breaks when the address changes.
  • found locally, not verified in DNS: only the host itself knows the name; your users' browsers may not reach it.
  • points to …, not to this server (for an IP address: not an address of this server): correct if a load balancer, a reverse proxy or a public NAT address forwards to this host.
  • short name; works only if users' DNS completes it: works only where your users' DNS completes it to the full name.
  • not found in DNS: your users' browsers will probably not reach it. Register the name in DNS first, or choose another one. If the check took about a minute, the host itself may not reach a DNS server; a name you know is registered can still be typed and confirmed.
  • not checked: the installer could not check the name in DNS from this host, because the host has no IPv4 address outside Docker or the DNS lookups failed.

Not allowed: idna as the server address or as its first part (for example idna.acme.com), even if the installer lists it. iDNA also uses the server address as the host name of its portal container, which can then no longer reach the container called idna. The installer does not check this.

Press Enter to accept option 1, or type the number of another option. You can also type a host name yourself, for example a DNS alias your users already know. If that name does not point to this host, the installer says what it found and asks Use it? [y/N]; answer N to return to the list. Enter only the name, without https://, port or path: at most 63 characters, or an IPv4 address. If users reach iDNA through a reverse proxy with another port or path, choose the proxy's name here and, after the installation, set PANAGENDA_METABASE_SITE_URL as well (see Configuration File). The installer confirms your choice with a line starting with "Selected:".

...

Code Block
languagetext
Server address: idna-apps.exampleacme.com
  iDNA Applications:  https://idna-apps.exampleacme.com/
  Metabase:           https://idna-apps.exampleacme.com/metabase
  Change later: run 'ifa hostname'
  Reachability check: https://idna-apps.exampleacme.com/metabase/api/health answered (HTTP 200).

...

SettingPurpose
PANAGENDA_HOSTNAMEThe server address: the name users open in their browser, also used for the Metabase reports and in the links of alert emails. Chosen during the installation; change it with ifa hostname rather than in the file.
PANAGENDA_TIMEZONEThe time zone of the containers. Detected from the host.
PANAGENDA_COMPOSE_NETWORK_SUBNETThe private /24 subnet of the internal Docker network, by default 192.168.238.0/24. Change it if your network already uses this subnet.
PANAGENDA_METABASE_SITE_URLThe address of the Metabase reports, by default https://<PANAGENDA_HOSTNAME>/metabase. Set it only if users reach Metabase through a reverse proxy with another port or path, in the form https://proxy.exampleacme.com:8443/metabase; for another name, change the server address with ifa hostname instead. While it is set, the installer does not ask for the server address.
PANAGENDA_POSTGRES_SHM_SIZEShared memory of the database, by default 2gb. Lower it only on small test hosts with less than 4 GB RAM.
PANAGENDA_ENABLE_MCPEnables the MCP server for AI clients, by default false (see Setting up the MCP Server).

...