Skip to content

[WIP] Improve "Self-Hosting" content#2284

Draft
tk-o wants to merge 9 commits into
mainfrom
docs/improve-self-hosting-content
Draft

[WIP] Improve "Self-Hosting" content#2284
tk-o wants to merge 9 commits into
mainfrom
docs/improve-self-hosting-content

Conversation

@tk-o

@tk-o tk-o commented Jun 11, 2026

Copy link
Copy Markdown
Member

Lite PR

Tip: Review docs on the ENSNode PR process

Summary


Why

  • Why this change exists. Link to related GitHub issues where relevant.

Testing

  • How this was tested.
  • If you didn't test it, say why.

Notes for Reviewer (Optional)

  • Anything non-obvious or worth a heads-up.

Pre-Review Checklist (Blocking)

  • This PR does not introduce significant changes and is low-risk to review quickly.
  • Relevant changesets are included (or are not required)

Copilot AI review requested due to automatic review settings June 11, 2026 11:08
@changeset-bot

changeset-bot Bot commented Jun 11, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 7b0125e

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@vercel

vercel Bot commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
enskit-react-example.ensnode.io Ready Ready Preview, Comment Jun 12, 2026 4:01pm
ensnode.io Ready Ready Preview, Comment Jun 12, 2026 4:01pm
2 Skipped Deployments
Project Deployment Actions Updated (UTC)
admin.ensnode.io Skipped Skipped Jun 12, 2026 4:01pm
ensrainbow.io Skipped Skipped Jun 12, 2026 4:01pm

@coderabbitai

coderabbitai Bot commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

This PR restructures the ENSNode self-hosting documentation by rewriting the index page, introducing new Deployment Options and Operations sections with Railway support, reorganizing sidebar navigation, adding URL redirects, and cleaning up frontmatter metadata.

Changes

Self-hosting documentation restructuring

Layer / File(s) Summary
Index page rewrite with consolidated next steps
docs/ensnode.io/src/content/docs/docs/self-host/index.mdx
Self-hosting intro replaced with direct benefits bullets, architecture entry point simplified, and separate Docker/Terraform deployment cards consolidated into unified "Deployment options" and "Operations" LinkCards in Next steps.
Deployment Options documentation section
docs/ensnode.io/src/content/docs/docs/self-host/deployment-options/index.mdx, docs/ensnode.io/src/content/docs/docs/self-host/deployment-options/railway.mdx
Created Deployment Options index page with LinkCards linking to Docker, Terraform, and new Railway deployment guides; added Railway guide page with Railway template reference.
Operations documentation section
docs/ensnode.io/src/content/docs/docs/self-host/operations/index.mdx, docs/ensnode.io/src/content/docs/docs/self-host/operations/monitoring.mdx, docs/ensnode.io/src/content/docs/docs/self-host/operations/critical-workloads.mdx
Added Operations overview page with LinkCard navigation; created Monitoring guide for tracking performance and health; created Critical Workloads guide detailing backfill, live indexing, API serving requirements and snapshot/hybrid setup recommendations.
Sidebar grouping, redirects, and frontmatter cleanup
docs/ensnode.io/config/integrations/starlight/sidebar-topics/self-host.ts, docs/ensnode.io/astro.config.mjs, docs/ensnode.io/src/content/docs/docs/self-host/deployment-options/docker.mdx, docs/ensnode.io/src/content/docs/docs/self-host/deployment-options/terraform.mdx, docs/ensnode.io/src/content/docs/docs/self-host/operations/scalability.mdx
Sidebar reorganized into grouped "Deployment options" (Docker, Railway, Terraform) and "Operations" sections; Scalability moved under Operations; URL redirects added for relocated paths (/docs/self-host/docker/docs/self-host/deployment-options/docker, etc.); order frontmatter fields removed from Docker, Terraform, and Scalability pages.
Hosted instances heading reorganization
docs/ensnode.io/src/content/docs/docs/hosted-instances.mdx
"ENSv1 + ENSv2 Instances" heading repositioned to appear before "ENSNode 'v2 Sepolia'" subsection.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

  • namehash/ensnode#2107: Modifies the same self-host/index.mdx file, adding snapshot-bootstrap content that this PR's rewrite consolidates into the Operations section.
  • namehash/ensnode#2146: Introduced the "Scalability" story page and sidebar entry that this PR now reorganizes under the Operations section with updated redirects.
  • namehash/ensnode#2173: Modifies hosted-instances.mdx concurrently; both PRs adjust the same page's subsection structure and content layout.

Suggested labels

docs


🐰 A warren of docs finds new paths,
Railway joins Docker on the map,
Operations grows its home within,
Sidebars grouped in tidy spin,
And redirects keep old links from falling!

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (1 warning, 1 inconclusive)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description is incomplete with unfilled template sections (Why, Testing, Notes for Reviewer) and unchecked blocking checklist items, though it does provide summary information about the main changes. Complete the Why section with motivation/issues, fill Testing section with how verification was performed, and check or explain the Pre-Review Checklist items.
Title check ❓ Inconclusive The title is vague and generic, using non-descriptive language like 'Improve' without conveying the specific nature of the self-hosting documentation reorganization. Revise the title to be more specific, such as 'Reorganize self-hosting guides with deployment options grouping and add Railway deployment documentation.'
✅ Passed checks (3 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/improve-self-hosting-content

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the “Self-host ENSNode” documentation page to better explain the practical benefits of self-hosting versus using publicly hosted instances, and to present deployment paths more clearly.

Changes:

  • Replaces the prior intro/note blocks with a more concrete benefits list (namespaces, plugins, ENSRainbow label sets, ENSDb readers/writers, etc.).
  • Reorganizes the deployment section into a single “Deployment options” area with richer LinkCard descriptions.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/ensnode.io/src/content/docs/docs/self-host/index.mdx Outdated
Comment thread docs/ensnode.io/src/content/docs/docs/self-host/index.mdx Outdated

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/ensnode.io/src/content/docs/docs/self-host/index.mdx`:
- Line 17: Replace the redundant phrase "your own strategies" in the sentence
"**Manage uptime**: apply your own strategies for ensuring high availability and
uptime guarantees." with a simpler wording such as "apply strategies for
ensuring high availability and uptime guarantees" so the line reads "**Manage
uptime**: apply strategies for ensuring high availability and uptime
guarantees."
- Around line 11-15: Fix the broken or unclear internal links and clean up the
minor wording repetition: verify and update the ENSRainbow anchor links in
index.mdx to use the exact heading slugs “#available-label-sets” and
“#how-ensrainbow-helps” (ensure the target headings in the ENSRainbow doc match
those slugs), confirm the ENSDb links point to the existing pages
(/docs/integrate/integration-options/ensdb, /ensdb-writers, /ensdb-readers) and
correct any path capitalization or trailing slashes, and simplify the duplicated
phrase on the subsequent line by removing the repeated “your own” to read
concisely (adjust the sentence near the “Manage uptime” line).
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 918646ef-3773-424b-9aa5-7e669c587106

📥 Commits

Reviewing files that changed from the base of the PR and between 6fa2f2f and 95a9393.

📒 Files selected for processing (1)
  • docs/ensnode.io/src/content/docs/docs/self-host/index.mdx

Comment thread docs/ensnode.io/src/content/docs/docs/self-host/index.mdx
Comment thread docs/ensnode.io/src/content/docs/docs/self-host/index.mdx Outdated

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated no new comments.

@tk-o tk-o force-pushed the docs/improve-self-hosting-content branch from 9332938 to cf7f980 Compare June 11, 2026 20:00
@vercel vercel Bot temporarily deployed to Preview – admin.ensnode.io June 11, 2026 20:00 Inactive
@vercel vercel Bot temporarily deployed to Preview – ensrainbow.io June 11, 2026 20:00 Inactive
Comment thread docs/ensnode.io/src/content/docs/docs/self-host/operations/critical-workloads.mdx Outdated
Comment thread docs/ensnode.io/src/content/docs/docs/self-host/index.mdx Outdated

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 12 out of 13 changed files in this pull request and generated 2 comments.

Comment thread docs/ensnode.io/src/content/docs/docs/self-host/index.mdx Outdated
Comment thread docs/ensnode.io/src/content/docs/docs/self-host/operations/monitoring.mdx Outdated
Comment thread docs/ensnode.io/src/content/docs/docs/self-host/operations/monitoring.mdx Outdated
Comment thread docs/ensnode.io/src/content/docs/docs/self-host/index.mdx
@vercel vercel Bot temporarily deployed to Preview – ensrainbow.io June 12, 2026 15:55 Inactive
@vercel vercel Bot temporarily deployed to Preview – admin.ensnode.io June 12, 2026 15:55 Inactive
@tk-o

tk-o commented Jun 12, 2026

Copy link
Copy Markdown
Member Author

@greptile review

Comment thread docs/ensnode.io/src/content/docs/docs/self-host/index.mdx Outdated
@@ -0,0 +1,13 @@
---

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The railway.mdx file is missing the sidebar frontmatter with a label property, causing inconsistency with docker.mdx and terraform.mdx

Fix on Vercel

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 12 out of 13 changed files in this pull request and generated 2 comments.


Operating an ENSNode deployment requires understanding the critical workloads that ENSNode is responsible for, as well as the best practices for managing and optimizing these workloads, including monitoring, scaling, and resource management. This section provides an overview of the key operational considerations for running your own ENSNode instance effectively.

### Next steps
Comment on lines +59 to +63
## ENSv1 + ENSv2 Instances

These instances are associated with an ENS namespace that has upgraded to ENSv1 + ENSv2 and demonstrate the latest support in ENSNode for ENSv1 and ENSv2 being concurrently activated together.

#### ENSNode 'v2 Sepolia'
### ENSNode 'v2 Sepolia'
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants