Docker
Deploy Spice.ai Enterprise using Docker container images.
Enterprise container images are distributed exclusively through the AWS Marketplace ECR registry. Subscribe to the Spice.ai Enterprise listing on AWS Marketplace, then authenticate with aws ecr get-login-password before pulling.
Prerequisites
- Docker
- AWS CLI (
aws) installed and configured with credentials for the account subscribed to the AWS Marketplace listing
Images
Replace <repo> below with either spiceai-enterprise-byol (Bring Your Own License) or spiceai-enterprise-plan (Marketplace subscription) — see AWS Marketplace for details. Replace <version> with the release to deploy, such as 2.3.2.
| Image | Description |
|---|---|
709825985650.dkr.ecr.us-east-1.amazonaws.com/spice-ai/<repo>:<version>-enterprise-models | Default distribution: data connectors, accelerators, search, and AI/ML model inference |
709825985650.dkr.ecr.us-east-1.amazonaws.com/spice-ai/<repo>:<version>-enterprise | Data-only distribution: excludes AI/ML model inference |
709825985650.dkr.ecr.us-east-1.amazonaws.com/spice-ai/<repo>:<version>-enterprise-jemalloc | jemalloc allocator variant, from 2.2.1 |
Pull an Image
aws ecr get-login-password --region us-east-1 \
| docker login --username AWS --password-stdin 709825985650.dkr.ecr.us-east-1.amazonaws.com
docker pull 709825985650.dkr.ecr.us-east-1.amazonaws.com/spice-ai/spiceai-enterprise-byol:2.3.2-enterprise-modelsRun
docker run -p 8090:8090 -p 50051:50051 -p 9090:9090 \
709825985650.dkr.ecr.us-east-1.amazonaws.com/spice-ai/spiceai-enterprise-byol:2.3.2-enterprise-models \
--http 0.0.0.0:8090 \
--metrics 0.0.0.0:9090 \
--flight 0.0.0.0:50051With a Spicepod Configuration
Mount a Spicepod YAML file into the container:
docker run -p 8090:8090 -p 50051:50051 -p 9090:9090 \
-v $(pwd)/spicepod.yaml:/app/spicepod.yaml \
709825985650.dkr.ecr.us-east-1.amazonaws.com/spice-ai/spiceai-enterprise-byol:2.3.2-enterprise-modelsExposed Ports
| Port | Protocol | Description |
|---|---|---|
8090 | HTTP | HTTP/SQL API |
50051 | gRPC | Apache Arrow Flight |
9090 | HTTP | Prometheus metrics |
Image Details
Enterprise images are built FROM scratch with a minimal filesystem containing:
- The
spicedbinary - CA certificates
- Timezone database
- Required shared libraries
The container runs as UID 65534 (nobody) for security.
Environment Variables
| Variable | Default |
|---|---|
HOME | /app |
HF_HOME | /.cache/huggingface |
SSL_CERT_FILE | /etc/ssl/certs/ca-certificates.crt |
SSL_CERT_DIR | /etc/ssl/certs |