Skip to content

System requirements

PoC profile

Item Reference profile
Machine One x64 VM, 4 vCPU, 16 GB RAM
Disk 100 GB SSD
System Linux x86_64 (Ubuntu 22.04 LTS, Debian 12 or later) or Windows Server 2022 x64 or later: minimums
Database PostgreSQL 18, pgvector built for PG18, unaccent extension
Files Managed SeaweedFS, binary included in the Backend package
Models Remote conversation, embedding, OCR and image services
User access VM DNS name, HTTPS to the Frontend service on TCP 9000
Administration sudo on Linux or an elevated Windows console for installation

This profile defines the documented scenario; it does not guarantee a simultaneous user count. No GPU is required on the VM because inference is remote. The PoC journey gives the installation sequence.

Operating systems

System Minimum required Validated
Linux x86_64, glibc 2.35 or later, systemd: Ubuntu 22.04 LTS, Debian 12 or later Ubuntu 24.04 LTS
Windows Windows Server 2022 x64 or later, 64-bit PowerShell 5.1 Windows Server 2022

Linux binaries are built against glibc 2.35: RHEL 9 and its derivatives (glibc 2.34) are not supported.

Host dependencies

Linux Windows
systemd Windows services and Windows Firewall; NSSM as an alternative mode
curl, for the procedure checks Visual Studio C++ tools, to build pgvector on the server or on a preparation workstation
Prepare PostgreSQL Prepare PostgreSQL

SmartAGT executables bundle their runtime: no Python needs to be installed on the server.

Network and certificates

Private network

SmartAGT is designed for a private network, without direct Internet exposure: Network exposure.

Prepare TLS identities for the Frontend service and public API, along with trust for connected external services. Encrypting PostgreSQL is recommended in production: PostgreSQL SSL. Align DNS, system time, certificate SANs and trusted authorities. The user workstation also trusts the Frontend service CA. The link between the Frontend service and the API, and managed storage, use certificates issued by SmartAGT: no certificate is required for them.

The upstream firewall allows the workstation network to reach TCP 9000 on the VM. Data ports remain restricted to components. On the API server, TCP ports 8010 and 8011 stay available for the Internal listener and the local enrollment endpoint, both on loopback on a single VM. A reverse proxy can present the Frontend service on 443 in the project journey.

Ports and flows lists sources and destinations. The Install your certificates procedure provides evaluation certificates or settings for your PKI.

Project sizing

Requirement Resource to assess
Conversation load Application CPU/RAM, provider concurrency, PostgreSQL connections and pools for concurrent conversations and long calls
Document ingestion Volume throughput and capacity, vector indexes, RAG workers and embedding API for the corpus and concurrent ingestion
Local processing Runtime CPU/GPU and memory, model cache and dependencies for OCR, local models or large pages
Generated files Image and object size, retention and storage access
High availability Role placement, shared data, PostgreSQL and storage availability
AI Gateway Additional processes and pools, external client throughput

The catalog's local OCR pipelines run on CPU. Their weights, decoded pages and concurrent calls require additional memory headroom and disk cache. Access to the weights repository is used for explicit preparation; extraction then reads the local cache, which must be accessible to the service account. Tesseract and its language data are not required.

These requirements are not implicitly included in the PoC's 16 GB. Project architectures explains their effect on component placement.