Skip to content

docs(pro): restore media into /opt/dojo/media for dojo-compose-cli installs - #16908

Open
stevewallone wants to merge 1 commit into
DefectDojo:devfrom
stevewallone:docs-pro-migration-media-restore
Open

stevewallone wants to merge 1 commit into
DefectDojo:devfrom
stevewallone:docs-pro-migration-media-restore

Conversation

@stevewallone

Copy link
Copy Markdown
Contributor

Description

In Migrating from Open Source to Self-Hosted DefectDojo Pro, the Compose example in Step 5 extracts the media archive into the named Docker volume defectdojo_media. That volume is how open source stores media. A Pro deployment installed with dojo-compose-cli doesn't use it: it bind-mounts /opt/dojo/media from the host, owned by uid 1001, the user the application containers run as. Anyone following the example ends up with uploaded files Pro never reads, and no error appears.

This PR:

  • puts the dojo-compose-cli restore first on the Compose tab: extract into /opt/dojo/media, then chown -R 1001:1001, with a note that /opt/dojo is the default install directory
  • keeps the named-volume command, labelled for deployments that use a defectdojo_media volume
  • makes the same change in all seven translations (de, es, fr, it, ja, pt-br, zh-hans)

The Kubernetes tab and the cloud version of the page are unchanged.

This overlaps #16502, which edits the same eight files. The change applies cleanly on top of #16502's current head, so whichever merges second needs only a trivial rebase.

Test results

Docs-only. Built the site with Hugo extended 0.153.5 and the production config, as CI does, with no errors. Checked the rendered Step 5 in English (Compose tab) and German.

Documentation

This PR is the documentation change.

🤖 Generated with Claude Code

…stalls

Step 5 of the self-hosted Pro migration guide only showed restoring the
media archive into the named Docker volume defectdojo_media, which is how
open source stores media. A Pro install made with dojo-compose-cli
bind-mounts /opt/dojo/media from the host instead, owned by uid 1001,
so following the example left the files where Pro never reads them.

Lead the Compose example with the /opt/dojo/media restore and chown, note
that /opt/dojo is the default install directory, and keep the volume
command for deployments that use one. Same change in the seven
translations.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant