[GH-ISSUE #124] [Feature]: Add existing host directories to File Manager (external folder mount / linked folders UX + docs) #68

Closed
opened 2026-05-06 12:25:26 +02:00 by BreizhHardware · 8 comments

Originally created by @S1N4X on GitHub (Jan 22, 2026).
Original GitHub issue: https://github.com/maziggy/bambuddy/issues/124

Originally assigned to: @maziggy on GitHub.

Problem or Use Case

What I’m trying to do
I’d like to make an existing directory on the Docker host appear inside Bambuddy’s File Manager without copying files into Bambuddy’s internal library. Example use case: I already have a large archive of .3mf, .stl, etc. on the host/NAS and want Bambuddy to browse/manage it.

Expected behavior

  • Ability to add/browse a host-mounted directory in File Manager (optionally read-only)
  • Clear way to configure this (Docker bind mount + UI selection of external path), with validation and good error messages
  • Documentation explaining the recommended setup and security considerations

Actual behavior

  • File Manager only shows the local Bambuddy library, and I don’t see a clear way to add an existing host directory.
  • If “linked folders with external path mounting” exists, I couldn’t find how to use it / it isn’t documented.

Environment
Bambuddy version: v0.1.6b10
Install method: Docker / docker-compose
OS: Unraid

Proposed Solution

  • Document a supported approach (example docker-compose.yml bind mount + UI steps).
  • If not implemented, add a UI workflow: “Add External Folder” → pick a mounted path → show it as a top-level entry in File Manager.
  • Add options: read-only vs read-write, hide dotfiles, allowed extensions, and path allowlist.

Notes
Release notes mention “linked folders with external path mounting” under File Manager features (v0.1.6b9). If this is already implemented, could you point to the UI/docs and/or clarify the required container mount path(s)?

Contribution

  • I would be willing to help implement this feature

Checklist

  • I have searched existing issues to ensure this feature hasn't already been requested
Originally created by @S1N4X on GitHub (Jan 22, 2026). Original GitHub issue: https://github.com/maziggy/bambuddy/issues/124 Originally assigned to: @maziggy on GitHub. ### Problem or Use Case **What I’m trying to do** I’d like to make an existing directory on the Docker host appear inside Bambuddy’s File Manager without copying files into Bambuddy’s internal library. Example use case: I already have a large archive of .3mf, .stl, etc. on the host/NAS and want Bambuddy to browse/manage it. **Expected behavior** - Ability to add/browse a host-mounted directory in File Manager (optionally read-only) - Clear way to configure this (Docker bind mount + UI selection of external path), with validation and good error messages - Documentation explaining the recommended setup and security considerations **Actual behavior** - File Manager only shows the local Bambuddy library, and I don’t see a clear way to add an existing host directory. - If “linked folders with external path mounting” exists, I couldn’t find how to use it / it isn’t documented. **Environment** Bambuddy version: v0.1.6b10 Install method: Docker / docker-compose OS: Unraid ### Proposed Solution - Document a supported approach (example docker-compose.yml bind mount + UI steps). - If not implemented, add a UI workflow: “Add External Folder” → pick a mounted path → show it as a top-level entry in File Manager. - Add options: read-only vs read-write, hide dotfiles, allowed extensions, and path allowlist. **Notes** Release notes mention “linked folders with external path mounting” under File Manager features (v0.1.6b9). If this is already implemented, could you point to the UI/docs and/or clarify the required container mount path(s)? ### Contribution - [x] I would be willing to help implement this feature ### Checklist - [x] I have searched existing issues to ensure this feature hasn't already been requested
BreizhHardware 2026-05-06 12:25:26 +02:00
Author
Owner

@maziggy commented on GitHub (Jan 22, 2026):

If you are willing to implement this, please go ahead. Every contribution is appreciated!

Let me know if you have any questions?

BTW: you can run the Github CI tests locally by using the test_*.sh files in root folder.

<!-- gh-comment-id:3783046849 --> @maziggy commented on GitHub (Jan 22, 2026): If you are willing to implement this, please go ahead. Every contribution is appreciated! Let me know if you have any questions? BTW: you can run the Github CI tests locally by using the test_*.sh files in root folder.
Author
Owner

@S1N4X commented on GitHub (Jan 24, 2026):

I'll try.
Would you share your claude.md for the project? Mainly for consistency.

<!-- gh-comment-id:3793440090 --> @S1N4X commented on GitHub (Jan 24, 2026): I'll try. Would you share your claude.md for the project? Mainly for consistency.
Author
Owner

@maziggy commented on GitHub (Jan 24, 2026):

Don't have, I'm only using Claude Code for various assistance tasks.

<!-- gh-comment-id:3794018264 --> @maziggy commented on GitHub (Jan 24, 2026): Don't have, I'm only using Claude Code for various assistance tasks.
Author
Owner

@maziggy commented on GitHub (Feb 10, 2026):

Are you still going to work on this?

<!-- gh-comment-id:3877690781 --> @maziggy commented on GitHub (Feb 10, 2026): Are you still going to work on this?
Author
Owner

@S1N4X commented on GitHub (Feb 12, 2026):

Hello,
yes. All the features are coded and have been unit tested, but I did not have time yet to fully test the rest of the webapp to be sure it is integrated nicely and without regressions. (I played with it a bit, but I want to be cautious).

It's passing the existing tests.

<!-- gh-comment-id:3888118061 --> @S1N4X commented on GitHub (Feb 12, 2026): Hello, yes. All the features are coded and have been unit tested, but I did not have time yet to fully test the rest of the webapp to be sure it is integrated nicely and without regressions. (I played with it a bit, but I want to be cautious). It's passing the existing tests.
Author
Owner

@maziggy commented on GitHub (Feb 12, 2026):

Take your time.

<!-- gh-comment-id:3888966552 --> @maziggy commented on GitHub (Feb 12, 2026): Take your time.
Author
Owner

@Bademeister89 commented on GitHub (Mar 15, 2026):

Hallo, ja. Alle Funktionen sind programmiert und wurden Unit-Tests unterzogen, aber ich hatte noch keine Zeit, den Rest der Webanwendung vollständig zu testen, um sicherzustellen, dass sie reibungslos integriert ist und keine Regressionen auftreten. (Ich habe ein wenig damit herumgespielt, möchte aber vorsichtig sein).

Es besteht die bestehenden Tests.

Will there be a release for this?

<!-- gh-comment-id:4062639324 --> @Bademeister89 commented on GitHub (Mar 15, 2026): > Hallo, ja. Alle Funktionen sind programmiert und wurden Unit-Tests unterzogen, aber ich hatte noch keine Zeit, den Rest der Webanwendung vollständig zu testen, um sicherzustellen, dass sie reibungslos integriert ist und keine Regressionen auftreten. (Ich habe ein wenig damit herumgespielt, möchte aber vorsichtig sein). > > Es besteht die bestehenden Tests. Will there be a release for this?
Author
Owner

@maziggy commented on GitHub (Mar 24, 2026):

Available/Fixed in branch dev and available with the next release or daily build.


If you find Bambuddy useful, please consider giving it a on GitHub — it helps others discover the project!

<!-- gh-comment-id:4116069555 --> @maziggy commented on GitHub (Mar 24, 2026): Available/Fixed in branch dev and available with the next release or daily build. ----- If you find Bambuddy useful, please consider giving it a ⭐ on [GitHub](https://github.com/maziggy/bambuddy) — it helps others discover the project!
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/bambuddy#68
No description provided.