oracle-aidb-docker-setup

Provision a local Oracle 26ai Free database in Docker with a project-specific application user.

4.3k|807|Updated Jan 16, 2024
One-click install
npx skills add https://github.com/oracle-devrel/oracle-ai-developer-hub --skill oracle-aidb-docker-setup
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: oracle-aidb-docker-setup
Source: https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/build-paths/skills/oracle-aidb-docker-setup
Command: npx skills add https://github.com/oracle-devrel/oracle-ai-developer-hub --skill oracle-aidb-docker-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Setting up a local Oracle 26ai Free database for development is often slow, fragile, and forces you to work as SYSTEM, which can break Oracle JSON validation for required objects like OracleVS; this Skill reliably provisions a containerized Oracle 26ai environment and creates a project-scoped application user tailored for downstream build-paths skills.

Core Features & Use Cases

  • Idempotent Docker Compose Provisioning: Creates or reuses a safe local Docker environment without clobbering an existing Oracle Free compose setup, preventing accidental overwrites.
  • Project-Scoped Credentials & DSN Output: Generates an .env with DB_DSN for FREEPDB1 and dedicated APP user credentials so other skills can connect without manual edits.
  • Correct App User for OracleVS & ONNX-Friendly Grants: Creates a non-SYSTEM user in the ASSM-enabled USERS tablespace and grants the required privileges, including EXECUTE on SYS.DBMS_VECTOR via a SYSDBA connection for the ONNX-friendly in-database vector path.
  • Use Case: When building a local agentic RAG, chat, or in-DB embeddings workflow that depends on OracleVS JSON columns and vector embedding support, this Skill is the one-time bootstrap that prepares the database to accept those objects.

Quick Start

Use the oracle-aidb-docker-setup skill to scaffold Docker Compose and a ready-to-use Oracle 26ai Free database in your project directory.

Frequently Asked Questions about oracle-aidb-docker-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up an Oracle 26ai Free database in Docker for local development?▼

Setting up an Oracle 26ai Free database in Docker involves generating a safe Docker Compose configuration and provisioning a container with a stable DSN for FREEPDB1, providing a ready-to-use local development environment.

Why does OracleVS JSON validation break when working as the SYSTEM user?▼

Using the SYSTEM user for OracleVS JSON workflows can break object validation. This Skill resolves the issue by provisioning a dedicated non-SYSTEM application user with the necessary grants in the ASSM-enabled USERS tablespace.

How do I create an app user with DBMS_VECTOR grants for Oracle 26ai?▼

Creating an app user with DBMS_VECTOR grants requires executing privileges via a SYSDBA connection. This Skill automates granting EXECUTE on SYS.DBMS_VECTOR to a project-scoped user for ONNX-friendly in-database vector paths.

Can I re-run Docker Compose provisioning without overwriting my existing Oracle database setup?▼

Yes, you can safely re-run Docker Compose provisioning. This Skill uses idempotent logic to reuse an existing local Oracle Free container setup without clobbering your current configuration or accidentally overwriting data.

Do I need a specific DSN to connect my RAG application to an Oracle 26ai Free container?▼

Yes, connecting a RAG application requires a stable DSN for FREEPDB1. This Skill generates an .env file with the DB_DSN and dedicated app credentials, allowing downstream build-paths skills to connect automatically.