You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
4. In your `values.yaml` file, configure the `hostBackendImage` and `operatorImage` options (if you need to mirror images)
78
+
4. In your `values.yaml` file, configure the `hostBackendImage` and `operatorImage` options (if you need to mirror images). If you are using a private container registry that requires authentication, you must also configure `imagePullSecrets`, refer to [Configure authentication for private registries](#optional-configure-authentication-for-private-registries).
79
+
79
80
5. You can also configure base templates for your agents by overriding the base templates [here](https://github.com/langchain-ai/helm/blob/main/charts/langsmith/values.yaml#L898).
80
81
81
82
Your self-hosted infrastructure is now ready to create deployments.
82
83
84
+
## (Optional) Configure authentication for private registries
85
+
86
+
If your [Agent Server deployments](/langsmith/agent-server) will use images from private container registries (e.g., AWS ECR, Azure ACR, GCP Artifact Registry, private Docker registry), configure image pull secrets. This is a one-time infrastructure configuration that allows all deployments to automatically authenticate with your private registry.
Replace the values with your registry credentials:
100
+
-`myregistry.com`: Your registry URL
101
+
-`your-username`: Your registry username
102
+
-`your-password`: Your registry password or access token
103
+
-`langsmith`: The Kubernetes namespace where LangSmith is installed
104
+
105
+
**Step 2: Configure the secret in your `values.yaml`**
106
+
107
+
```yaml
108
+
images:
109
+
imagePullSecrets:
110
+
- name: langsmith-registry-secret
111
+
```
112
+
113
+
**Step 3: Apply during Helm installation/upgrade**
114
+
115
+
When you deploy or upgrade your LangSmith instance using Helm, this configuration will be applied. All user deployments created through the LangSmith UI will automatically inherit these registry credentials.
116
+
117
+
For registry-specific authentication methods (AWS ECR, Azure ACR, GCP Artifact Registry, etc.), refer to the [Kubernetes documentation on pulling images from private registries](https://kubernetes.io/docs/tasks/configure-pod-container/pull-image-private-registry/).
118
+
83
119
## Next steps
84
120
85
121
Once your infrastructure is set up, you're ready to deploy applications. See the deployment guides in the [Deployment tab](/langsmith/deployments) for instructions on building and deploying your applications.
Copy file name to clipboardExpand all lines: src/langsmith/deploy-with-control-plane.mdx
+16-1Lines changed: 16 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -33,7 +33,7 @@ Before completing this guide, you'll need the following:
33
33
-[Hybrid setup](/langsmith/deploy-hybrid): Installs data plane components (listener, operator, CRDs) in your Kubernetes cluster that connect to LangChain's managed control plane.
34
34
-[Enable LangSmith Deployment](/langsmith/deploy-self-hosted-full-platform): Enables LangSmith Deployment on your self-hosted LangSmith instance.
35
35
- Access to the [LangSmith UI](https://smith.langchain.com) with LangSmith Deployment enabled.
36
-
- A container registry accessible by your Kubernetes cluster.
36
+
- A container registry accessible by your Kubernetes cluster. If using a private registry that requires authentication, you must configure image pull secrets as part of your infrastructure setup. Refer to [Private registry authentication](#private-registry-authentication).
37
37
38
38
## Step 1. Test locally
39
39
@@ -117,6 +117,21 @@ Starting from the LangSmith UI:
117
117
- Adjust other settings as needed.
118
118
1. Select **Submit**.
119
119
120
+
## Private registry authentication
121
+
122
+
If your container registry requires authentication (e.g., AWS ECR, Azure ACR, GCP Artifact Registry, private Docker registry), you must configure Kubernetes image pull secrets before deploying applications. This is a one-time infrastructure configuration.
123
+
124
+
<Note>
125
+
**This configuration is done at the infrastructure level, not per-deployment.** Once configured, all deployments automatically inherit the registry credentials.
126
+
</Note>
127
+
128
+
The configuration steps depend on your deployment type:
129
+
130
+
-**Self-hosted with control plane**: Configure `imagePullSecrets` in your LangSmith Helm chart's `values.yaml` file. See the detailed steps in the [Enable LangSmith Deployment guide](/langsmith/deploy-self-hosted-full-platform#setup).
131
+
-**Hybrid**: Configure `imagePullSecrets` in your `langgraph-dataplane-values.yaml` file using the same format.
132
+
133
+
For detailed steps on creating image pull secrets for different registry providers, refer to the [Kubernetes documentation on pulling images from private registries](https://kubernetes.io/docs/tasks/configure-pod-container/pull-image-private-registry/).
134
+
120
135
## Next steps
121
136
122
137
-**[Control plane](/langsmith/control-plane)**: Learn more about control plane features.
0 commit comments