Skip to Content
Browse documentation

app.conf Reference

Configure an Eenos app identity, language, version, update script and independent WAP, RAPP and UAPP availability.

app.conf is an INI file at the root of the extracted package. Include [settings], [wap], [rapp] and [uapp]: deployment accesses the three panel sections directly even though the initial validator checks mainly [settings].

Complete minimal example

[settings]
name = exampleapp
menu = Example App
description = A read-only example panel extension
language = python
version = 1.0.0
version_check_url =
auto_update =

[wap]
status = on
open_new_window = off

[rapp]
status = off
open_new_window = off

[uapp]
status = off
open_new_window = off

This enables only the WAP interface. For a PHP package, use language = php and provide the corresponding PHP files and vhosts. Do not enable another interface before its code, assets and authorization are ready.

Settings

KeyMeaning and current behavior
nameNonempty app identifier; must match the panel folder, static folder and manifest identity. Use a unique identifier such as exampleapp.
menuNonempty sidebar label shared by enabled panel entries.
descriptionDescription used by installed-app listing. Include it even though initial validation does not require it.
languagepython or php; stored in lowercase.
versionNonempty installed-version text.
version_check_urlOptional URL returning the available version as plain text. Include an empty key when unused so listing code can read it. An invalid URL logs a warning during initial validation rather than necessarily rejecting installation.
auto_updateInstalled executable script path used by the update action. Empty means no updater is configured.

The current version listing compares installed and remote strings for inequality. It is not semantic-version ordering, signature verification or automatic installation. A different remote version can be flagged even when it is older.

Panel sections

KeyMeaning
statusUse on to install/expose the interface, or off to leave it disabled.
open_new_windowUse on to request a new browser window from the menu, otherwise off. It does not create a new authentication boundary.

Deployment normalizes these values to on or off and records a separate global app status. Global disable prevents panel entries from loading even if an individual panel flag says on.

The installer also records deployed script, hook and vhost paths. Treat /var/eenos/apps/<appname>.yaml and generated panel registries as installed metadata, not files to ship in place of app.conf.