Administrators can rebrand MokoNtfy from Site Administration › Branding. All of the changes below take effect live — no rebuild and no server restart.
System name
Change the name displayed throughout the app (title bar, login page, installed-app name). The default is MokoNtfy. Update the name in Branding and it applies immediately across the web app and the web manifest.
Theme (Mokonyx)
MokoNtfy ships with the Mokonyx theme by default. From Branding you can override the theme's color, accent, and font for this instance. Each instance can set its own values, so a white-labeled deployment can match a customer's palette.
Favicon & app icon
Upload a single SVG icon in Branding. From that one file MokoNtfy generates and serves:
- the browser favicon,
- the PWA icons at 192 px and 512 px,
- the Apple touch icon, and
- the app splash image.
The uploaded icon is served ahead of the built-in defaults, again with no rebuild. Use Reset to revert to the built-in MokoNtfy icon at any time.
Operator note: enabling icon upload
The SVG icon upload has to be turned on by the operator before it can be used. It requires a writable, persistent directory where MokoNtfy can store the uploaded asset and the icons it generates from it. The operator sets this with the NTFY_BRAND_ASSET_DIR environment variable, or the equivalent brand-asset-dir option in server.yml, and points it at a directory that survives restarts and redeploys.
Until that directory is configured, the Branding page shows “Icon upload is not enabled on this server.” and the upload control is unavailable. The system name and theme controls still work; only the icon upload depends on this setting. Once the directory is set, icon upload is fully self-service from the Branding page.