[Bug]: docker build fails

[gmuth]

What happened?

=> ERROR [opencloudtouch backend 8/13] COPY .out/dist ./frontend/dist 0.0s

[+] Running 0/1uch backend 8/13] COPY .out/dist ./frontend/dist:
⠴ Service opencloudtouch Building 4.5s
failed to solve: failed to compute cache key: failed to calculate checksum of ref bfaed728-2e6e-42ac-ba82-42f2411d7757::3tzggq2cr2ef95o77tb1rag1h: "/.out/dist": not found

Steps to Reproduce

docker compose -f deployment/docker-compose.yml up -d --build

Expected Behaviour

build works

Affected Area

Radio Search

OpenCloudTouch Version

current

Deployment Type

Other

Browser & Device

No response

Screenshots

No response

Backend Logs

Frontend Logs (Browser Console)

Additional Context

No response

[oct-support]

Thank you for reporting this issue! 🐛

To help us investigate, could you please provide more details using our bug report template?

Specifically, we need:

1. Steps to reproduce the issue
2. Expected vs actual behavior
3. Your environment (device model, OS, browser)

This will help us resolve the issue faster. Thanks!

[scheilch]

Hi @gmuth! 👋

This isn't a bug in OpenCloudTouch -- the error occurs because the Docker build expects the frontend to be pre-built in .out/dist, which only exists after running the frontend build step.

Quick fix (building from source)

If you want to build from source, you need to build the frontend first:

cd apps/frontend
npm install
npm run build
cd ../..
docker compose -f deployment/docker-compose.yml up -d --build

Easier alternative: Use the pre-built image (recommended)

Unless you need to modify the source code, simply use the published image:

docker run -d \
  --name opencloudtouch \
  --network host \
  -v opencloudtouch-data:/data \
  ghcr.io/scheilch/opencloudtouch:stable

Or with docker-compose, just remove the build section and use image: ghcr.io/scheilch/opencloudtouch:stable instead.

📺 Setup walkthrough: OpenCloudTouch Tutorial (YouTube)

I've removed the bug label since this is a usage question. Let me know if the pre-built image works for you!

[gmuth]

I just tried to follow the recommended Option 1 as documented and expected a multi stage build to build all required components. So the documentation is incorrect?

[scheilch]

Hey @gmuth, you're absolutely right — great catch! 🙌

The documentation for Option 1 was indeed misleading. Our Dockerfile expects the frontend to be pre-built in .out/dist/ (which CI provides automatically), but we didn't mention that anywhere. Running docker compose ... --build on a fresh clone will always fail with that COPY .out/dist error.

I've just updated the README to fix this:

• Option 1 is now docker run with the pre-built GHCR image (works out of the box)
• Option 2 is Docker Compose in pull mode (no build required)
• Building from source is documented separately with the required frontend pre-build step

Thanks a lot for reporting this — documentation bugs like this are super valuable because they hit every new user. Really appreciate you taking the time! 🙏

The fix will land in main shortly. In the meantime, the pre-built image (ghcr.io/scheilch/opencloudtouch:stable) should get you up and running immediately.