You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@superset.apache.org by "shubhamjrd4559-sudo (via GitHub)" <gi...@apache.org> on 2026/10/26 05:11:04 UTC
[I] docs(docker): warn that down -v deletes local Superset data [superset]
shubhamjrd4559-sudo opened a new issue, #45731:
URL: https://github.com/apache/superset/issues/45731
### Bug description
The **Local packages** section in [docker/README.md](https://github.com/apache/superset/blob/master/docker/README.md#L56-L67) instructs contributors to run:
`docker compose down -v`
The root [docker-compose.yml](https://github.com/apache/superset/blob/master/docker-compose.yml#L28-L35) mounts the named `superset_home` volume, and [defines `db_home` for PostgreSQL data](https://github.com/apache/superset/blob/master/docker-compose.yml#L104-L113). Docker Compose's `down -v` removes project volumes, so following this package-rebuild step can erase a developer's local metadata database and Superset data. This is a documentation issue; no runtime failure is being reported.
### Steps to reproduce
1. Start the default Docker Compose stack and create or import local Superset content.
2. Follow the README's **Local packages** steps to add a package to `docker/requirements-local.txt`.
3. Run the documented `docker compose down -v`, then `docker compose up`.
### Expected behavior
The documented package rebuild/restart flow preserves persistent Superset data. Any command that removes volumes is clearly identified as an intentional destructive reset.
### Actual behavior
The documented `down -v` removes the named database and home volumes, so the next startup no longer has the previous local metadata and stored content.
### Screenshots/recordings
_No response_
### Superset version
master / latest-dev
### Python version
3.11
### Node version
16
### Browser
Chrome
### Additional context
This is a documentation-only report; Python, Node.js, browser, and Superset runtime versions do not affect the behavior of `docker compose down -v`. I searched the GitHub issue tracker for the package-rebuild instruction and `down -v`. Related results include Discussion #37610 (a package-download/network failure) and Issue #24589 (older container dependency troubleshooting); neither reports this README data-loss risk.
### Checklist
- [ ] I have searched Superset docs and Slack and didn't find a solution to my problem.
- [x] I have searched the GitHub issue tracker and didn't find a similar bug report.
- [ ] I have checked Superset's logs for errors and if I found a relevant Python stacktrace, I included it here as text in the "additional context" section.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org
Re: [I] docs(docker): warn that down -v deletes local Superset data [superset]
Posted by "shubhamjrd4559-sudo (via GitHub)" <gi...@apache.org>.
shubhamjrd4559-sudo commented on issue #45731:
URL: https://github.com/apache/superset/issues/45731#issuecomment-6408799847
I would like to take this issue and contribute a focused documentation PR to update the Docker package-rebuild instructions so they preserve the named volumes and clearly warn before any destructive reset. Could a maintainer please assign this issue to me or confirm that I may proceed?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org
Re: [I] docs(docker): warn that down -v deletes local Superset data [superset]
Posted by "hainenber (via GitHub)" <gi...@apache.org>.
hainenber closed issue #45731: docs(docker): warn that down -v deletes local Superset data
URL: https://github.com/apache/superset/issues/45731
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org