Deployment Overview

The Agent Factory application runs in a container, an isolated package that lets the application run consistently across environments. Agent Factory uses Podman and Podman Compose to run on supported Linux and macOS hosts.

Currently supported operating systems:

Oracle Linux 8 on AMDx86_64
Oracle Linux 8 on ARM64
MAC OS ARM64 (M.x chipsets)
MAC OS Intel

Prerequisites

Regardless of the platform, Agent Factory requires the following prerequisites:

Oracle AI Database repository: Production mode requires access to an Oracle AI Database instance that will store Agent Factory repository tables, configuration, flow definitions, and runtime metadata. Create a dedicated user for this purpose. Use this user exclusively for Agent Factory’s repository tables and not for storing unrelated production data. See Database Preparation and Grants.

Note: Oracle Database Knowledge Assistant requires that the user tablespace be a BIGFILE tablespace or at least 100GB.

Important: For production mode installations, the max_string_size database parameter must be set to EXTENDED, regardless of the environment. See Set MAX_STRING_SIZE Parameter to EXTENDED.
LLM endpoint: Agent Factory relies on integration with a Large Language Model to function properly. You need network access and credentials for an available LLM provider. See Configure LLM.
Embedding model: Knowledge Agent, Deep Data Research Agent, and retrieval workflows require an embedding model. Embeddings can use local models, OCI Generative AI, Gemini, vLLM, or Ollama depending on your deployment.
Network access: The Agent Factory container must be able to reach the repository database, LLM and embedding providers, configured data sources, MCP servers, REST APIs, and any tracing provider you configure. Browser access alone is not sufficient.
TLS and DNS plan: For production, decide the browser-facing host name before configuring SSO, MCP OAuth, REST OAuth, or certificates. Callback URLs must exactly match the externally reachable URL.

Installation Modes

Oracle AI Database Private Agent Factory offers two installation modes:

Production: Production mode lets you manually set up the repository database, LLM endpoint, embedding model, TLS, proxy, SSO, and enterprise connectors. Use this mode for shared environments, private subnet deployments, production-like testing, and any deployment that must connect to external enterprise services.
Quickstart: Quickstart mode creates a local database container and configures Agent Factory so you can evaluate the product without preparing a separate repository database. Use Quickstart for evaluation, demos, and local development. Do not use Quickstart as a substitute for a production deployment plan.

By default, the container running Oracle AI Database Private Agent Factory uses port 8080. If you install on Quickstart mode, the Oracle AI Database 26ai free instance runs on port 1521. Ensure this port is available on your system to avoid installation issues.

Parameter	Quickstart Mode	Production Mode
Setup	Automated, local containers	Manual, user provided endpoints
Database	Local database container supplied by the kit	User-provided Oracle AI Database repository
LLM	User selected LLM (Ollama/OpenAI/vLLM/Google/OCI Gen AI)	User selected LLM (Ollama/OpenAI/vLLM/Google/OCI Gen AI)
Storage	~30 GB	~10 GB
RAM	~10 GB	~8 GB
Ports	8080, 1521, 11434	8080

Review your environment and operational requirements before choosing the installation mode. If more than one user or team will depend on the deployment, use Production mode.

LLM Preferences

Generative Models:

Below are the recommended options, listed in order of preference:

OCI Generative AI (most preferred)
OpenAI/Google
vLLM
Ollama

Embedding Models:

Below are the recommended options, listed in order of preference:

OCI Generative AI (most preferred)
Google
vLLM
Ollama
Local

Types of Setup

Oracle AI Database Private Agent Factory can be installed on both Linux and Mac environments. For both operating systems, you can choose between Production and Quickstart installation modes, with or without a VPN connection. Please refer to the appropriate links in the table for detailed setup instructions for your specific platform and installation scenario.

Linux

Oracle AI Database Private Agent Factory offers support for Linux environments based on X86-64 and ARM64 architectures.

Installation mode	VPN on	VPN off
Production	Linux-Prod-With VPN	Linux-Prod-No VPN
Quickstart	Linux-Quickstart-With VPN	Linux-Quickstart-No VPN

Mac

Oracle AI Database Private Agent Factory is certified for Mac systems based on Intel and Apple Silicon Chips.

Installation mode	VPN on	VPN off
Production	Mac-Prod-With VPN	Mac-Prod-No VPN
Quickstart	Mac-Quickstart-With VPN	Mac-Quickstart-No VPN