Page History
| Table of Contents | ||
|---|---|---|
|
Overview
This page takes you from a prepared Linux host to the first login to iDNA Applications, and describes how to operate the installation afterwards. What the host needs is described in Running iDNA on your own Linux; upgrades in Upgrading iDNA Applications.
...
Before the installation starts, the installer asks for the server address: the name users type in their browser to open iDNA and its Metabase reports. iDNA also uses it in the links of Metabase emails and in iDNA alert emails.
| Warning | ||
|---|---|---|
| ||
Do not use |
The installer suggests names and checks each one in DNS, which takes a few seconds, up to a minute if DNS does not answer. It then lists them with the best one first:
| Code Block | ||
|---|---|---|
| ||
===================================================================== 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]: |
...
| Code Block | ||
|---|---|---|
| ||
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). |
...
- Save the certificate as
certfile.pem(PEM format, followed by any intermediate certificates) and the private key askeyfile.key(PEM format, without a passphrase). Keep exactly these file names. - Copy both files to
/opt/panagenda/appdata/volumes/nginx/. Restart iDNA:
Code Block language bash ifa restart
...
The installer creates the configuration file /opt/panagenda/appdata/ifa/config with the server address you chose and the values it detects on the host. Later runs do not replace the file; they only change single settings: the server address when you choose one, and the time zone after you confirm it. Settings you may want to change:
| Setting | Purpose |
|---|---|
PANAGENDA_HOSTNAME | The 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_TIMEZONE | The time zone of the containers. Detected from the host. |
PANAGENDA_COMPOSE_NETWORK_SUBNET | The 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_URL | The 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. |
acme.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_SIZE | Shared memory of the database, by default 2gb. Lower it only on small test hosts with less than 4 GB RAM. |
PANAGENDA_ENABLE_MCP | Enables the MCP server for AI clients, by default false (see Setting up the MCP Server). |
The file may also contain PANAGENDA_CONFIRMED_HOSTNAME. The installer and ifa hostname write it to remember that the server address was confirmed; do not edit it.
...
Operate iDNA with the command ifa as root:
| Command | What it does |
|---|---|
ifa start | Starts the containers if they are not running. |
ifa stop | Stops the containers. |
ifa restart | Restarts the containers. |
ifa down | Stops and removes the containers; all data is kept. |
ifa recreate | Stops, removes and starts the containers. Use it after changing the configuration file. |
ifa hostname | Shows the current server address and lets you choose a new one on the same screen as during the installation (needs a terminal). If you choose a different address, it asks whether to apply it right away, which makes iDNA unavailable for a few minutes, and shows the addresses as at the end of the installation. If you apply right away, the reachability check may report "could not reach" only because the containers are still starting. |
ifa hostname <name> | Checks the name and saves it as the server address without questions; if the name does not point to this host, it says what it found. Apply it with ifa recreate. |
ifa diagnose-network | Checks whether the internal Docker network collides with networks known to the host. Changes nothing. |
ifa uninstall | Removes iDNA Applications including the database (see Uninstalling). |
Logs
- Installer:
/opt/panagenda/logs/ifa-upgrade_<date>_<time>.log, one file per run. Attach it to every support request about an installation or upgrade. - Services:
/opt/panagenda/logs/<service>/, for exampleidna,dda,postgresornginx. iDNA deletes these files after 7 to 14 days. - Containers:
docker logs panagenda_<service>shows the latest output of a container; add-fto follow it.
...