# X-Edge AI Box & Runtime

> Industrial Edge AI platform for real-time predictive analytics, anomaly detection, and operational optimization.

## Overview

- [Product Overview](https://xisom-docs.pages.dev/product-overview/): What Xisom Edge AI Box & Runtime is, who it's for, and how it fits your industrial stack.
- [Use Cases](https://xisom-docs.pages.dev/use-cases/): How customers deploy Xisom Edge AI in production.

## Install & Deploy

- [Offline Bundle Install](https://xisom-docs.pages.dev/install-deploy/offline-bundle-install/): Install the Xisom Edge AI Box on an air-gapped site from the offline release bundle — load images, run the installer, set secrets, bring the stack up, and verify health.
- [Quickstart](https://xisom-docs.pages.dev/install-deploy/quickstart/): Run your first inference on Xisom Edge AI Box in 15 minutes.
- [Hardware Setup](https://xisom-docs.pages.dev/install-deploy/hardware-setup/): Provision the Xisom Edge AI Box, pick an execution-provider mode, and connect it to your network.
- [Your First Inference](https://xisom-docs.pages.dev/install-deploy/first-inference/): Seed a model, enable a datasource, and watch live predictions appear on the dashboard.

## Configure

- [Connecting Input Datasources](https://xisom-docs.pages.dev/configure/input-datasources/): Stream sensor and process data into the Xisom runtime — add an OPC-UA, MQTT, or CSV source, map tags, pair a model, enable, and start inference.
- [Output Datasources](https://xisom-docs.pages.dev/configure/output-datasources/): Write predictions and setpoints back to external systems — configure an OPC-UA, MQTT, or Modbus output and verify it with a test write.
- [Deploying Models](https://xisom-docs.pages.dev/configure/models/): Upload an ONNX model, pair it with an input datasource, and activate it on the Xisom runtime.

## Operate

- [Monitoring](https://xisom-docs.pages.dev/operate/monitoring/): Read the inference dashboard — latency breakdown, throughput, error rate, and the window/bucket time controls.
- [Versions & Updates](https://xisom-docs.pages.dev/operate/versioning/): Read the About panel, understand frontend/backend version drift, and know what it means operationally.
- [Docker Lab Walkthrough](https://xisom-docs.pages.dev/operate/docker-lab/): Stand up the full Xisom stack locally with Docker Compose for evaluation and integration testing.

## Troubleshooting

- [Troubleshooting](https://xisom-docs.pages.dev/troubleshooting/): Symptom-first runbook for diagnosing and fixing common Xisom Edge AI Box issues.
- [GPU not used — CUDA error 500](https://xisom-docs.pages.dev/troubleshooting/gpu-cuda-error-500/): Inference container logs "CUDA failure 500" and falls back to CPU though a GPU is installed.
- [Running on CPU when GPU expected](https://xisom-docs.pages.dev/troubleshooting/execution-provider-fallback/): Inference degrades to a lower execution provider (TensorRT → CUDA → CPU) though the GPU works.
- [Datasource down or faulted](https://xisom-docs.pages.dev/troubleshooting/datasource-down-or-faulted/): An OPC-UA / MQTT / CSV datasource stops streaming, or a row shows a fault indicator.
- [Frontend / backend version mismatch](https://xisom-docs.pages.dev/troubleshooting/version-drift-fe-be/): The About panel highlights a version mismatch between the frontend and backend in amber.
- [Disk fills / database grows unbounded](https://xisom-docs.pages.dev/troubleshooting/sqlite-retention-disk/): The observability database grows far beyond its live data and fills the disk.
- [Container marked unhealthy but service works](https://xisom-docs.pages.dev/troubleshooting/healthcheck-ipv6-false-negative/): A container reports unhealthy while it serves traffic fine — a health-probe false negative.

## Reference

- [API Reference](https://xisom-docs.pages.dev/api-reference/overview/): REST and gRPC APIs exposed by the Xisom runtime.
- [FAQ](https://xisom-docs.pages.dev/faq/): Frequently asked questions about Xisom Edge AI Box & Runtime.
- [Release Notes](https://xisom-docs.pages.dev/release-notes/): Operator-relevant changes for the Xisom Edge AI Box & Runtime.
- [Security](https://xisom-docs.pages.dev/security/): How Xisom protects access to your models, data, and operations — authentication, access control, hardened containers, and the audit trail.
- [Support](https://xisom-docs.pages.dev/support/): How to reach the Xisom team and get help.

## Translations

- [English](https://xisom-docs.pages.dev/): English documentation
- [한국어 (Korean)](https://xisom-docs.pages.dev/ko/): 한국어 (Korean) documentation
- [Tiếng Việt (Vietnamese)](https://xisom-docs.pages.dev/vi/): Tiếng Việt (Vietnamese) documentation