4 Configuration

OwnSona reads every setting from a single file: src/main/backend/application.ini. The file is INI-format, all keys live under the [main] section, and the servlet loads it once at startup via Kiss’s MainServlet.readIniFile mechanism.

The file is gitignored. A template lives at src/main/backend/application.ini.example; copy it on first install and edit in place.

When a change to application.ini takes effect. Editing the source-tree copy alone does nothing. The build (./bld -v build && ./bld war) copies the file into the WAR. When you replace the deployed WAR, the servlet picks up the new values on next start. Tomcat’s autoDeploy="true" restarts the webapp automatically about ten seconds after the WAR replaces the previous one; restart the service explicitly with systemctl restart ownsona.service if you want it immediate.