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 = offThis 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
| Key | Meaning and current behavior |
|---|---|
name | Nonempty app identifier; must match the panel folder, static folder and manifest identity. Use a unique identifier such as exampleapp. |
menu | Nonempty sidebar label shared by enabled panel entries. |
description | Description used by installed-app listing. Include it even though initial validation does not require it. |
language | python or php; stored in lowercase. |
version | Nonempty installed-version text. |
version_check_url | Optional 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_update | Installed 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
| Key | Meaning |
|---|---|
status | Use on to install/expose the interface, or off to leave it disabled. |
open_new_window | Use 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.