Quick Installation¶
This guide walks you through installing Trust3 using Docker, the recommended deployment method for getting started quickly and easily.
Prerequisites¶
System requirements depend on how you run the AI Assets Collector:
- Docker — quick test or a single host; see Run Collector (Docker tab).
- Runtime on K8s — production deployment in your own cluster (for example EKS or AKS); see Run Collector (Runtime on K8s tab).
Docker setup¶
Use this path when you want a fast local evaluation or to run the collector on one machine with Docker Compose.
Host system requirements¶
| Requirement | Specification |
|---|---|
| CPU | 2+ cores |
| RAM | 4+ GB |
| Disk | 10 GB free space |
| OS | Linux, macOS, or Windows (with Docker Desktop) |
Required software¶
| Software | Version |
|---|---|
| Docker | 20.10+ (Install) |
| Docker Compose | 2.0+ (included with Docker Desktop) |
Network¶
- Outbound HTTPS from the host to your Databricks and/or Azure APIs (for discovery).
- Outbound HTTPS to the Trust3 API and container registry used by your tenant (see Run Collector for
docker loginand ingest settings).
Platform prerequisites¶
Complete before you create .env:
| If you collect from… | Guide |
|---|---|
| Databricks | Databricks prerequisites |
| Azure / Power Platform | Azure prerequisites |
Kubernetes (Runtime on K8s)¶
Use this path when collectors must run inside your own cluster—for example network-restricted Databricks or Azure environments, or policies that require Kubernetes-native deployment.
Cluster requirements¶
| Requirement | Specification |
|---|---|
| Kubernetes | Supported cluster (for example Amazon EKS or Azure AKS) in the region you select when creating the runtime |
| Access | kubectl configured for the target cluster; permissions to create namespaces and deploy Helm releases in the runtime namespace |
| Network | Outbound-only internet access from the cluster to Trust3 (Runtime Plane connects outbound; no inbound connectivity from the internet into the cluster is required for the control-plane link) |
Required software (workstation)¶
| Software | Purpose |
|---|---|
| curl or wget | Download the Trust3 runtime installation script (shown in the Trust3 dashboard after you create a runtime) |
| Helm | 3.x — install the Trust3 Runtime Plane into your cluster |
| kubectl | Verify runtime and collector pods after deployment |
Trust3 Runtime¶
| Requirement | Notes |
|---|---|
| Trust3 account | Sign in to Trust3 Cloud and access Settings > Runtime |
| Deployment type | Partially Managed (D2P) with Basic Config |
| Cloud provider | AWS or Azure, matching where your cluster runs |
| Prerequisites checklist | Confirm AWS Prerequisites or Azure Prerequisites in the dashboard before Generate |
Platform prerequisites¶
Same datasource prerequisites as Docker—configure them when adding AI Assets Collector under Collectors:
| If you collect from… | Guide |
|---|---|
| Databricks | Databricks prerequisites |
| Azure / Power Platform | Azure prerequisites |
Setup¶
-
Obtain Docker Compose File - Please contact Trust3 Support at support@trust3ai.com to request Docker Compose file.
-
Create
.envfile in installation directory: -
Authenticate with Docker Registry:
Bash -
Start Trust3 Services:
Bash -
Verify services are running:
Bash -
Access Trust3 Portal at
http://localhost:9000 - Username:
admin - Password:
welcome1
Next Steps¶
-
Connect Data Sources
[ Connect your data sources] ../manage-context/connect-datasources/datasources.md
-
Create IQ Space
[ Create your first IQ Space] ../manage-context/manage-context.md
-
Start Querying
[ Learn how to ask IQ questions] ../get-started/ask-iq.md
-
Manage Installation
[ Manage, Troubleshoot and Uninstall] manage-install.md