persistent mode persists both data and code

Open
#762 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
45/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Stale
Tech stack
docker, shell

Research direction

Start with the persistent mode instructions linked in the issue and inspect how the quickstart container uses /opt/stellar for data, configuration, and code. Determine a persistence layout that allows data to survive while new image code and configuration are applied, then verify that upgrading the container no longer leaves the old soroban-rpc expectation in place.

Written by the indexing model from the issue text.

Description

bug

In the instructions for persistent mode, we tell users to mount a volume to /opt/stellar in the quickstart container.

This is problematic because that directory contains data, configuration, and code. Different versions of quickstart will have updated configuration and/or code. But, because the entire /opt/stellar directory is persisted, any changes to code and/or configuration will not be applied when running a new version of the quickstart container with the old mounted volume.

This exact situation occurred recently in https://stellarfoundation.slack.com/archives/C098N5WJCL8/p1757101644045819?thread_ts=1757078276.261149&cid=C098N5WJCL8 , where someone was running a quickstart version before soroban-rpc got renamed to stellar-rpc. The script contained within the /opt/stellar directory expected a soroban-rpc binary to be present. But the new quickstart image uses the stellar-rpc binary and no soroban-rpc binary exists.

Dominant language
Shell
Stars
222
Forks
236
Avg merge
1d 12h
Merged PRs (30d)
12

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from stellar/quickstart

All issues in stellar/quickstart

Similar issues

More Shell/Bash issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.