The SambaNova administrator guide is intended for users of SambaStack. This guide provides comprehensive step-by-step workflows for deploying, configuring, and maintaining SambaStack. Core topics include setup, installation, optional configuration, user group management, monitoring and logging, artifact management, and bundle deployment. The guide supports both initial onboarding and ongoing system management.

​
Intended audience

This guide is intended for system and platform administrators responsible for installing and managing SambaStack. Users should have:
  • Familiarity with system administration
  • Familiarity with Kubernetes concepts and kubectl usage
  • Access to required system-level credentials

​
Using this guide

The guide is organized into sections that follow a deployment lifecycle:
  • Setup – Prepare your environment and verify prerequisites.
  • Installation – Install SambaStack and validate deployment.
  • Optional configuration – Customize deployments with TLS, external databases, and authentication.
  • User group management - Manage user permissions, configure admin access, and set up service tiers and Quality of Service (QoS) levels.
  • Monitoring and logs - Use Grafana and OpenSearch Dashboards to track system health, performance trends, and logs for proactive troubleshooting.
  • Artifact management - Organize and update model artifacts, configurations, and supporting assets to keep deployments stable and reproducible.
  • Bundle deployment and management - Deploy, configure, and manage bundles in SambaStack.
Use the navigation menu to move between topics. Each section includes prerequisites, step-by-step tasks, and validation checks.

​
Pre-built settings

SambaNova provides preconfigured system components to streamline deployment and reduce administrative effort. These include:
  • Installer scripts and Kubernetes manifests for deploying core services
  • A default Keycloak instance for authentication (optional)
  • Monitoring and logging integrations
  • Reference sambastack.yaml configuration file for quick start

​
System access and permissions

To manage SambaStack, ensure you have:
  • Cluster-level admin privileges in Kubernetes.
  • Permissions to create Namespaces, ConfigMaps, Secrets, and Deployments.
  • Access credentials for SambaNova services (if using hosted options)

​
Customization options (optional)

SambaStack Hosted allows optional customization of certain components. SambaNova provisions and manages these components by default, but you can override them with your own configuration if needed. Available customization options include:
  • Custom host URLs
  • External Postgres database
  • Custom OIDC authentication
For detailed setup instructions, see the following documentation: