Support Portal

Overview

Your CaraOne server arrives pre-configured by Scale Logic. Day-to-day behavior is managed from the BackOffice web interface, and every option is stored in a single configuration file, settings.json. This article explains how to reach BackOffice and what the key settings do, using a sample user named scalelogic.

Accessing BackOffice

BackOffice is hosted on the head node and served through Nginx. Open it from a browser on the CaraOne network:

http://<server-ip>:9092

The default login is admin

Service ports

Keep the three ports contiguous (9090–9092) to simplify firewall and monitoring rules.

Users and the per-user model

CaraOne is organized per user. Each user has its own database, watch folders, and proxy/thumbnail storage. In every example below the user is scalelogic.

Storage and watch folders

All CaraOne working data lives under working_dir (default /opt/caraone_data). Media and proxy locations are configured per user and need to be on shared storage:

• FOLDERS_TO_WATCH — the media to index; should be a real, read-only mounted filesystem.
• FOLDERS_TO_WATCH_PRIORITY — folders indexed ahead of the rest.
• FOLDERS_TO_EXCLUDE / PATTERNS_TO_EXCLUDE — paths and patterns in file names to skip (e.g. *proxy*).
• DON'T INDEX FILE TYPE  — a list of file paths to be skipped during indexing
• PROXY_FOLDER_PATH / THUMBNAIL_FOLDER_PATH — where generated proxies and thumbnails are stored. Keep these separate from watched media so indexing does not loop.

Auto path tuples (the .caraone marker)

Drop an empty file named .caraone in the root of each media mount and CaraOne registers the client↔server path mapping automatically at startup — one marker per mount.

Indexing window

INDEX_TIMES sets the daily start and stop time for indexing. Two equal values (e.g. "00:00","00:00") mean index continuously.

Feature toggles

API access

The REST API listens on REST_API_IP : REST_API_PORT (default 9090). Programmatic API / Construction Kit access is available to integration partners under a Scale Logic agreement — contact your distributor to enable it.  Only change if there is a conflict.

Advanced settings

log_level ranges 1–6 (4 = Info, recommended; 6 = maximum debug). REST_THREADS tunes API concurrency, and T_MODEL / I_MODEL select the transcription and image-analysis model versions.  Do not change in normal operation.

Editing settings and applying changes

Most settings can be changed in BackOffice. Advanced edits can be made directly in /opt/caraone/dist/settings/settings.json. Always restart the CaraOne service after saving changes.

Example settings.json (user: scalelogic)

{
  "users": ["scalelogic"],
  "REST_API_IP": "10.0.1.16",
  "REST_API_PORT": 9090,
  "USE_OCR": true,
  "LANGUAGE": "en",
  "INDEX_TIMES": ["00:00", "00:00"],
  "DO_FACE_RECOGNITION": true,
  "EXPORT_EDITRATE": 24.0,
  "working_dir": "/opt/caraone_data",
   "FOLDERS_TO_WATCH": { "scalelogic": ["/mnt/flash/media/video/Scale Logic"] },
   "FOLDERS_TO_WATCH_PRIORITY": { "scalelogic": ["/mnt/scalelogic_media/priority"] },
   "FOLDERS_TO_EXCLUDE": { "scalelogic": ["/mnt/scalelogic_media/ignore"] },
   "THUMBNAIL_FOLDER_PATH": { "scalelogic": "/mnt/flash/media/proxies/ainode_1/thumbnails" },
   "PROXY_FOLDER_PATH": { "scalelogic": "/mnt/flash/media/proxies/ainode_1/proxy" },
   "FACES_PATHS": { "scalelogic": ["/mnt/scalelogic_media/faces1",       "/mnt/scalelogic_media/faces2"] },
   "database_PATH": "/opt/caraone_data/database",
   "log_level": 5,
   "USE_LLM": true,
   "DO_MAGIC": true,
   "INDEX_VIDEO_ONLY": false,
   "INDEX_DOCS": false
                                          }

Job-queue, timeout and worker-count keys are managed by Scale Logic and are omitted here.