Advanced Configuration

Local Development Ports

For local app serving and optional local APIs, you can define ports in data/localhost-ports.config.json.

{
  "appPort": 61291,
  "llmProxyPort": 61292,
  "nodeApiPort": 61293
}

• appPort: local static app server used by python-scripts/start_app.py
• llmProxyPort: local Python LLM proxy port
• nodeApiPort: optional Node.js REST API dev server port

If the file is missing or invalid, built-in defaults are used.

When the app runs on localhost, 127.0.0.1, or ::1, the frontend LLM client automatically reads this file to find the local proxy port. On a deployed web server it uses /api/llm, and on file:// it does not use a local proxy.

DB Configuration

The app uses a configuration automatically embedded in index.html:

<div
  id="jsonjsdb-config"
  style="display:none;"
  data-app-name="datannur-app"
  data-path="data/db"
></div>

💡 Best Practice: Instead of editing index.html directly, modify the configuration in /data/jsonjsdb-config.html and then:

• Run python3 python-scripts/update_app.py to automatically apply the configuration, OR
• Manually copy the configuration block from /data/jsonjsdb-config.html to index.html

This approach ensures your configuration is preserved during application updates.

app-name

The data-app-name parameter is an application identifier used as a namespace for user data stored in the browser (favorites, search history, settings).

Default value: "datannur-app"

Use case: Change this value when running multiple catalog instances from the same location to keep user data separate. For example, use "catalog-dev" and "catalog-prod" to isolate development and production environments.

path

The data-path parameter defines the path to your database folder (default: "data/db").

• Can be a relative path from the index.html location
• Examples: "data/db", "my-catalog/database", "../shared-data/db"

db-key (Optional)

The data-db-key parameter provides security enhancement against data exfiltration by malicious scripts running in the browser on file://.

<div
  id="jsonjsdb-config"
  style="display:none;"
  data-app-name="datannur-app"
  data-path="data/db"
  data-db-key="R63CYikswPqAu3uCBnsV"
></div>

This configuration expects your data files to be in /data/db/{key}/, making file paths unpredictable to malicious scripts.