Skip to content

Comments

docs: Add Docker to Scaffold Stellar prerequisites#2267

Open
Copilot wants to merge 2 commits intomainfrom
copilot/add-docker-to-prerequisites
Open

docs: Add Docker to Scaffold Stellar prerequisites#2267
Copilot wants to merge 2 commits intomainfrom
copilot/add-docker-to-prerequisites

Conversation

Copy link
Contributor

Copilot AI commented Feb 20, 2026

stellar scaffold watch requires a running Docker daemon to spin up a local Stellar node via the stellar/quickstart image, but Docker was absent from the prerequisites table — causing new users to hit an opaque connection error mid-setup.

Changes

  • docs/tools/scaffold-stellar.mdx — Added Docker row to the prerequisites table (EN)
  • i18n/es/.../tools/scaffold-stellar.mdx — Same addition in Spanish
  • i18n/es/.../tools/developer-tools/scaffold-stellar.mdx — Same addition in the alternate Spanish location

New row added across all three files:

Tool Description Install Link
Docker For running a local Stellar network via the stellar/quickstart image Download Docker Desktop
Original prompt

This section details on the original issue you should resolve

<issue_title>Docs: Add Docker to Prerequisites for Scaffold Stellar</issue_title>
<issue_description>### What version are you using?

scaffold-stellar-frontend@0.0.1

What did you do?

  1. Followed the "Getting Started" guide for Scaffold Stellar. https://developers.stellar.org/docs/tools/scaffold-stellar#prerequisites
  2. Ran stellar scaffold init my-project.
  3. Ran npm start to begin local development as instructed by the scaffold output.
  4. Note: Docker Desktop was not installed/running on the machine because it was not listed as a prerequisite.

What did you expect to see?

I expected the local development environment (local network, contract deployment, and frontend) to start successfully, or to have been informed in the "Prerequisites" section that a Docker runtime is required for the default local development flow.

What did you see instead?

The process failed immediately during the stellar scaffold watch phase because it could not find a Docker daemon to start the local Stellar node.

Error Output:

[stellar] ℹ️  Starting local Stellar Docker container...
[stellar] ℹ️  Starting local network
[stellar] ⚠️  Failed to connect to Docker daemon at unix:///var/run/docker.sock.
[stellar] ℹ️  Attempting to connect to the default Docker Desktop socket at /Users/steph/.docker/run/docker.sock instead.
[stellar] Failed to start Stellar Docker container: DockerConnectionFailed(BollardErr(HyperLegacyError { err: hyper_util::client::legacy::Error(Connect, Os { code: 2, kind: NotFound, message: "No such file or directory" }) }))
[stellar] ❌ Build error: Failed to start docker container

Suggested Fix:
Add Docker to the list of Prerequisites on the documentation page. While experienced Stellar developers might know the CLI relies on the stellar/quickstart Docker image for local testing, new users following the tutorial for the first time are likely to encounter this "missing dependency" error.
</issue_description>

Comments on the Issue (you are @copilot in this section)


🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. Learn more about Advanced Security.

Co-authored-by: oceans404 <91382964+oceans404@users.noreply.github.com>
Copilot AI changed the title [WIP] Add Docker to prerequisites for Scaffold Stellar docs: Add Docker to Scaffold Stellar prerequisites Feb 20, 2026
Copilot AI requested a review from oceans404 February 20, 2026 17:42
@oceans404 oceans404 requested a review from briwylde08 February 20, 2026 17:46
@oceans404 oceans404 marked this pull request as ready for review February 20, 2026 17:53
Copilot AI review requested due to automatic review settings February 20, 2026 17:54
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates Scaffold Stellar documentation to explicitly list Docker as a prerequisite, preventing setup failures when stellar scaffold watch attempts to start a local network via the stellar/quickstart Docker image.

Changes:

  • Added a Docker prerequisite row to the English Scaffold Stellar prerequisites table.
  • Added the same Docker prerequisite row to both Spanish Scaffold Stellar doc locations.

Reviewed changes

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

File Description
docs/tools/scaffold-stellar.mdx Adds Docker to prerequisites for running a local Stellar network via stellar/quickstart.
i18n/es/docusaurus-plugin-content-docs/current/tools/scaffold-stellar.mdx Mirrors the Docker prerequisite addition in Spanish.
i18n/es/docusaurus-plugin-content-docs/current/tools/developer-tools/scaffold-stellar.mdx Mirrors the Docker prerequisite addition in the alternate Spanish path.

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

| [Rust & Cargo](https://www.rust-lang.org/tools/install) | For writing and compiling smart contracts | `curl https://sh.rustup.rs -sSf \| sh` |
| [Node.js & npm](https://nodejs.org/) | For frontend development | Download from official site |
| [Stellar CLI](https://github.com/stellar/stellar-cli) | For building, deploying, and interacting with smart contracts | [`Link for the repo`](https://github.com/stellar/stellar-cli) |
| [Docker](https://www.docker.com/get-started/) | For running a local Stellar network via the `stellar/quickstart` image | [Download Docker Desktop](https://www.docker.com/products/docker-desktop/) |
Copy link

Copilot AI Feb 20, 2026

Choose a reason for hiding this comment

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

The install link text is “Download Docker Desktop”, which is Mac/Windows-specific and can be misleading for Linux users (who typically install Docker Engine). Consider using a more general install label/link (e.g., “Get Docker” pointing to Docker’s official install docs) so the prerequisite applies across platforms.

Suggested change
| [Docker](https://www.docker.com/get-started/) | For running a local Stellar network via the `stellar/quickstart` image | [Download Docker Desktop](https://www.docker.com/products/docker-desktop/) |
| [Docker](https://www.docker.com/get-started/) | For running a local Stellar network via the `stellar/quickstart` image | [Get Docker](https://docs.docker.com/get-docker/) |

Copilot uses AI. Check for mistakes.
| [Rust & Cargo](https://www.rust-lang.org/tools/install) | Para escribir y compilar contratos inteligentes | `curl https://sh.rustup.rs -sSf \| sh` |
| [Node.js & npm](https://nodejs.org/) | Para el desarrollo frontend | Descarga desde el sitio oficial |
| [Stellar CLI](https://github.com/stellar/stellar-cli) | Para construir, desplegar e interactuar con contratos inteligentes | [`Link for the repo`](https://github.com/stellar/stellar-cli) |
| [Docker](https://www.docker.com/get-started/) | Para ejecutar una red Stellar local mediante la imagen `stellar/quickstart` | [Descargar Docker Desktop](https://www.docker.com/products/docker-desktop/) |
Copy link

Copilot AI Feb 20, 2026

Choose a reason for hiding this comment

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

El texto del enlace de instalación dice “Descargar Docker Desktop”, lo cual es específico de Mac/Windows y puede confundir a usuarios de Linux (donde normalmente se instala Docker Engine). Considera usar un texto/enlace más general (p. ej., “Obtener Docker” con el enlace oficial de instalación) para que el prerrequisito aplique en todas las plataformas.

Suggested change
| [Docker](https://www.docker.com/get-started/) | Para ejecutar una red Stellar local mediante la imagen `stellar/quickstart` | [Descargar Docker Desktop](https://www.docker.com/products/docker-desktop/) |
| [Docker](https://www.docker.com/get-started/) | Para ejecutar una red Stellar local mediante la imagen `stellar/quickstart` | [Obtener Docker](https://docs.docker.com/get-docker/) |

Copilot uses AI. Check for mistakes.
| [Rust & Cargo](https://www.rust-lang.org/tools/install) | Para escribir y compilar contratos inteligentes | `curl https://sh.rustup.rs -sSf \| sh` |
| [Node.js & npm](https://nodejs.org/) | Para el desarrollo del frontend | Descargar desde el sitio oficial |
| [Stellar CLI](https://github.com/stellar/stellar-cli) | Para construir, desplegar e interactuar con contratos inteligentes | [`Link for the repo`](https://github.com/stellar/stellar-cli) |
| [Docker](https://www.docker.com/get-started/) | Para ejecutar una red Stellar local mediante la imagen `stellar/quickstart` | [Descargar Docker Desktop](https://www.docker.com/products/docker-desktop/) |
Copy link

Copilot AI Feb 20, 2026

Choose a reason for hiding this comment

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

El texto del enlace de instalación dice “Descargar Docker Desktop”, lo cual es específico de Mac/Windows y puede confundir a usuarios de Linux (donde normalmente se instala Docker Engine). Considera usar un texto/enlace más general (p. ej., “Obtener Docker” con el enlace oficial de instalación) para que el prerrequisito aplique en todas las plataformas.

Suggested change
| [Docker](https://www.docker.com/get-started/) | Para ejecutar una red Stellar local mediante la imagen `stellar/quickstart` | [Descargar Docker Desktop](https://www.docker.com/products/docker-desktop/) |
| [Docker](https://www.docker.com/get-started/) | Para ejecutar una red Stellar local mediante la imagen `stellar/quickstart` | [Obtener Docker](https://docs.docker.com/get-docker/) |

Copilot uses AI. Check for mistakes.
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.

Docs: Add Docker to Prerequisites for Scaffold Stellar

2 participants