Skip to content

Expand existing deploy docs #610

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
viniciusdc wants to merge 4 commits into
base: main
Choose a base branch
from
Draft

Expand existing deploy docs #610

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
98c3e59
expand existing deploy docs
viniciusdc Jan 6, 2026
62dbf81
fix build & update k3s setup docs
viniciusdc Jan 6, 2026
51b9a2a
add mermaid dep, update k3s docs
viniciusdc Jan 7, 2026
2db639f
fix broken link
viniciusdc Jan 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 16 additions & 7 deletions docs/docs/get-started/deploy.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,17 +48,26 @@ For instructions on installing and deploying Nebari Local, please visit [Deployi

</TabItem>

<TabItem value="existing" label="Pre-existing Kubernetes cluster">
<TabItem value="existing" label="Existing infrastructure">

This approach is recommended if you are already using Kubernetes and want to deploy Nebari on your existing cluster.
This approach is recommended if you have existing infrastructure and want to deploy Nebari on:

For instructions on installing and deploying Nebari on an existing Kubernetes cluster, please visit [How to install and setup Nebari on an existing Kubernetes infrastructure](/docs/how-tos/nebari-kubernets.mdx).
- **Pre-existing Kubernetes clusters** (EKS, AKS, GKE, or custom clusters)
- **Bare metal servers** using our K3s setup

:::note
As of now, we have only tested this functionality for AWS, but we are continuously working on expanding to other cloud providers.
:::
Choose this option if:
- You have existing cloud-managed Kubernetes clusters (EKS, AKS, GKE)
- You want to deploy on bare metal infrastructure
- You're migrating from traditional HPC systems
- You need full control over your infrastructure

You should choose another installation option, likely a cloud install if you are starting from scratch (you have no compute clusters already in place) and you desire to stand up a production instance of Nebari.
For detailed instructions:
- [Deploy Nebari on bare metal with K3s](/docs/how-tos/nebari-bare-metal.mdx) - Set up a K3s cluster on bare metal and deploy Nebari
- [Deploy Nebari on existing Kubernetes clusters](/docs/how-tos/nebari-kubernets.mdx) - Deploy on pre-existing EKS, AKS, GKE, or custom clusters

:::tip
The bare metal deployment using [nebari-k3s](https://github.com/nebari-dev/nebari-k3s) provides a modern Kubernetes-based alternative to traditional HPC batch systems and replaces the deprecated nebari-slurm project.
:::

</TabItem>
</Tabs>
Expand Down
Loading
Loading