lance-format / lance-format/lance-data-viewer
feat: better error messages for file permission failures
Open
@gordonmurray is already working on this.
Since Apr 6, 2026.
enhancement
- Dominant language
- Python
- Stars
- 60
- Forks
- 9
- Avg merge
- 10m
- Merged PRs (30d)
- 4
Description
When lance-data-viewer runs as UID 1001 (the default non-root user) and mounts a volume where .lance files were written by a different UID (e.g., 1000 from an Airflow or application container), the error is:
LanceError(IO): Generic LocalFileSystem error: Unable to open file /data/imag...
The message is truncated and doesn't indicate that the root cause is a permission denial. This is a common scenario when running lance-data-viewer alongside other containers in Docker Compose.
Proposed improvements:
- Catch permission errors explicitly and return a user-friendly message including the current UID and the file owner UID
- Add a startup check: after connecting to
DATA_PATH, attempt to read a sample file and log a warning if permissions are insufficient, rather than failing silently per-dataset - Add a troubleshooting note to the README about volume permissions when sharing data between containers
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.