Skip to content

Conversation

@leighmcculloch
Copy link
Member

What

Relocate history archive storage from /tmp/stellar-core/history/vs to /opt/stellar/history-archive/data. Update stellar-core config and supervisor config to use the new path.

Why

History archive data is lost across container restarts because /tmp is not included in the standard /opt/stellar volume mount for persistent mode.

Close #871

@leighmcculloch leighmcculloch requested a review from a team January 7, 2026 03:34
@github-project-automation github-project-automation bot moved this to Backlog (Not Ready) in DevX Jan 7, 2026
@leighmcculloch leighmcculloch requested a review from Copilot January 7, 2026 03:34
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

This PR relocates the history archive storage from /tmp/stellar-core/history/vs to /opt/stellar/history-archive/data to ensure persistence across container restarts in persistent mode. The /tmp directory is not included in the standard /opt/stellar volume mount, causing history archive data loss on container restarts.

Key Changes:

  • Updated history archive path from /tmp/stellar-core/history/vs to /opt/stellar/history-archive/data in both stellar-core configuration and supervisor configuration
  • Changes only affect the local network configuration (testnet, pubnet, and futurenet use remote history archives)

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
local/supervisor/etc/supervisord.conf.d/history-archive.conf Updated the working directory for the history archive HTTP server to point to the new persistent location
local/core/etc/stellar-core.cfg Updated all HISTORY.vs commands (get, put, mkdir) to use the new persistent path under /opt/stellar

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

@leighmcculloch leighmcculloch marked this pull request as ready for review January 7, 2026 03:39
Copy link

@mootz12 mootz12 left a comment

Choose a reason for hiding this comment

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

Just curious - why only history archives for local networks?

@leighmcculloch
Copy link
Member Author

why only history archives for local networks?

The history archives fro networks are big enough to be non-trivial for a non-local, even testnet when its nearing its reset period. The history archival would be partial only based on what the quickstart image had seen in ledgers, so it wouldn't have all of history. Someone testing with quickstart with a non-local network could just point to a history archive sitting on s3 and they'll get a better experience.

Maybe there's some utility for it, but it hasn't shown up yet.

@leighmcculloch leighmcculloch enabled auto-merge (squash) January 8, 2026 05:49
@leighmcculloch leighmcculloch merged commit d0716c1 into main Jan 8, 2026
89 checks passed
@leighmcculloch leighmcculloch deleted the historyarchiveloc branch January 8, 2026 05:59
@github-project-automation github-project-automation bot moved this from Backlog (Not Ready) to Done in DevX Jan 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

Move history archive to /opt/stellar for persistence

3 participants