Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mirage.strukto.ai/llms.txt

Use this file to discover all available pages before exploring further.

Credentials

The OCI resource needs:
  • an Object Storage bucket
  • your Object Storage namespace
  • your OCI region
  • a Customer Secret Key pair for the S3 Compatibility API

1. Create a Bucket

  1. Open the OCI Console
  2. Go to Storage -> Buckets
  3. Choose the target compartment
  4. Click Create bucket
  5. Enter the bucket name, such as mirage
  6. Keep the storage tier as Standard unless you specifically want archive
If you want MIRAGE data under a prefix like data/, create objects under that prefix inside the bucket. The prefix is not part of the bucket name.

2. Get the Namespace

  1. Open the profile menu in the OCI Console
  2. Go to Tenancy
  3. Copy the Object Storage namespace string, such as idsiqbdbcr4i
You can also fetch it with:
oci os ns get

3. Get S3-compatible Keys

  1. Open the profile menu
  2. Go to User settings
  3. Open Customer secret keys
  4. Click Generate secret key
  5. Copy both the Access Key and Secret Key
Oracle only shows the secret once, so save it immediately.

4. Find the Region

Use the OCI Console region selector in the top-right. For example:
  • us-ashburn-1
  • us-phoenix-1
  • eu-frankfurt-1

5. Set Environment Variables

# .env.development
OCI_BUCKET=mirage
OCI_NAMESPACE=idsiqbdbcr4i
OCI_REGION=us-ashburn-1
OCI_ACCESS_KEY_ID=...
OCI_SECRET_ACCESS_KEY=...
For Python configuration, see the Python OCI Setup guide.