Skip to content

docs: add celestia-app Docker setup guide - #2438

Open
jcstein wants to merge 3 commits into
mainfrom
codex/issue-1100-celestia-app-docker
Open

docs: add celestia-app Docker setup guide#2438
jcstein wants to merge 3 commits into
mainfrom
codex/issue-1100-celestia-app-docker

Conversation

@jcstein

@jcstein jcstein commented Mar 6, 2026

Copy link
Copy Markdown
Member

Summary

  • add a dedicated celestia-app Docker guide under consensus validators
  • document quick start with persistent storage, genesis download, and peer config
  • add a Docker network example for running celestia-node against containerized celestia-app
  • add cross-links from existing Docker and install pages

Closes #1100

@gemini-code-assist gemini-code-assist 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.

Code Review

This pull request adds a new documentation page for running celestia-app with Docker. The new guide is comprehensive and covers prerequisites, a quick start guide with persistent storage, and instructions for running celestia-node against the containerized celestia-app. The changes also include adding cross-links from other relevant pages. My review focuses on the new documentation file. I've found a few minor issues in the shell commands for configuring persistent peers. The commands can be improved for correctness and consistency by properly handling trailing commas in the peer lists. I've provided suggestions to fix these.

Comment thread app/operate/consensus-validators/docker/page.mdx Outdated
Comment thread app/operate/consensus-validators/docker/page.mdx Outdated
Comment thread app/operate/consensus-validators/docker/page.mdx Outdated
@github-actions

github-actions Bot commented Mar 6, 2026

Copy link
Copy Markdown
Contributor

🚀 Preview Deployment

Your preview is ready: https://celestiaorg.github.io/docs-preview/pr-2438/

Copilot AI added a commit that referenced this pull request Mar 6, 2026
Co-authored-by: jcstein <46639943+jcstein@users.noreply.github.com>
@jcstein jcstein self-assigned this Mar 6, 2026
@celestiaorg celestiaorg deleted a comment from gemini-code-assist Bot Mar 6, 2026
@jcstein
jcstein requested a review from Copilot March 7, 2026 06:11

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

Adds a dedicated Docker-based setup guide for running celestia-app (consensus) and cross-links it from existing celestia-node Docker and celestia-app install documentation.

Changes:

  • Add new celestia-app Docker guide with persistent storage, genesis download, peer configuration, and a shared-network example with celestia-node.
  • Cross-link the new guide from the existing celestia-node Docker page and celestia-app install page.
  • Register the new Docker guide in the consensus validators sidebar metadata.

Reviewed changes

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

File Description
app/operate/getting-started/docker/page.mdx Adds a link to the new celestia-app Docker guide from the celestia-node Docker page.
app/operate/consensus-validators/install-celestia-app/page.mdx Adds a link to Docker-based setup instructions for celestia-app.
app/operate/consensus-validators/docker/page.mdx New page documenting how to run celestia-app via Docker, plus a shared Docker network example with celestia-node.
app/operate/consensus-validators/_meta.js Adds the new Docker guide entry to the consensus validators sidebar.

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

Comment thread app/operate/consensus-validators/docker/page.mdx
Comment thread app/operate/consensus-validators/docker/page.mdx
jcstein and others added 2 commits July 30, 2026 13:13
Align with seeds-first P2P setup, gRPC core.port 9090, localhost-bound
RPC/gRPC publishes, and cleaner peer list formatting.

Co-authored-by: Cursor <cursoragent@cursor.com>
@jcstein

jcstein commented Jul 30, 2026

Copy link
Copy Markdown
Member Author

Refreshed this PR against current main:

  • Rebased (~137 commits behind → up to date)
  • Seeds-first P2P setup (persistent peers optional, matching consensus-node guide)
  • celestia-node example uses --core.port 9090 (gRPC)
  • RPC/gRPC published to localhost only, with exposure warning
  • Trailing-comma cleanup on peer/seed lists

@jcstein
jcstein force-pushed the codex/issue-1100-celestia-app-docker branch from 30419c5 to afc3190 Compare July 30, 2026 19:15
celestia-node reaches celestia-app over the Docker network on gRPC 9090,
so publishing those ports to the host is unnecessary exposure.

Co-authored-by: Cursor <cursoragent@cursor.com>
@jcstein
jcstein requested a review from gbarros July 30, 2026 19:33
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.

feat: add documentation for running celestia-app docker images

2 participants