Deploying with Dockerfile occurs: error: failed to solve: failed to read downloaded context: failed to load cache key: invalid response status 404

[starryacat]

Describe the bug
In version 0.0.5^, when performing an initial installation on Debian 13 hosted on Hetzner and attempting to deploy the app via Dockerfile, the following error occurs. (I have not yet verified if this occurs with a more simple Dockerfile.)

Stream opened, loading build logs...

-----------------------------------------------
 Deployment:   813cc141-857b-4a57-9934-a668a88f4103
 App:          app--4689413a
 Project:      proj--68705a7d
-----------------------------------------------
[2026-03-01T08:41:38.908Z]: Initialized app build...
[2026-03-01T08:41:38.909Z]: Trying to clone repository...
[2026-03-01T08:41:40.105Z]: Cloned repository successfully
[2026-03-01T08:41:40.105Z]: Latest remote git hash: 0e8d67534f17f85f098a188950a6caaf9ba5f68e
[2026-03-01T08:41:40.106Z]: Creating build job with name: build-app--4689413a-b901fe82
[2026-03-01T08:41:40.106Z]: Dockerfile context path: root directory of Git Repository. Dockerfile name: Dockerfile
[2026-03-01T08:41:40.128Z]: Build job build-app--4689413a-b901fe82 started successfully
2026-03-01T08:41:41.076916705Z #1 [internal] load remote build context
2026-03-01T08:41:41.404781750Z #1 ERROR: invalid response status 404
2026-03-01T08:41:41.449565549Z ------
2026-03-01T08:41:41.449582328Z  > [internal] load remote build context:
2026-03-01T08:41:41.449585583Z ------
2026-03-01T08:41:41.452768832Z error: failed to solve: failed to read downloaded context: failed to load cache key: invalid response status 404
[2026-03-01T08:41:45.185Z]: [END] Log stream ended for build process: build-app--4689413a-b901fe82

To Reproduce
Steps to reproduce the behavior:

1. Install Quickstack on Debian 13 running on Hetzner.
2. Deploy any Dockerfile via Git.
3. Error occurs.

Expected behavior
The build succeeds and the app is deployed.

Screenshots
None.

Desktop (please complete the following information):
Client:

• OS: macOS 15.7.3 (24G419)
• Browser: Google Chrome
• Version 144.0.7559.110 (arm)

Server: (Single Node)

• OS: Debian 13

Additional context
I have confirmed it works with 0.0.4.
Dockerfile is:

FROM node:24

WORKDIR /main_ver

COPY main_ver/package*.json ./

RUN npm install

COPY main_ver/ .

CMD ["node", "src/main.js"]

[biersoeckli]

Hey @starryacat,

Thanks for reaching out.

In version 0.0.5 the tool responsible for the build step was changed from Kaniko to BuildKit. Kaniko is no longer actively maintained, so I switched to BuildKit, which is the same build engine Docker uses when running docker build. In practice this means that any Dockerfile you can build locally with Docker should also work on QuickStack.

There might still be an issue when using Debian, since I tested QuickStack only on Ubuntu so far.

Have you already tried updating your QuickStack instance to the latest version?

I will set up a Debian test server and run some tests with QuickStack using a few sample projects. I will get back to you once I have more information.

[biersoeckli]

I just tested installing QuickStack on Debian 13 and building and deploying a dummy Node.js app (https://github.com/biersoeckli/dummy-node-app). Running the latest version of QuickStack, I did not encounter any issues.

I looked again at the logs you shared. It appears that the build process cannot find the Dockerfile. Is your Dockerfile located in a subfolder rather than the repository root (./Dockerfile)?

If so, did you specify the correct relative path to the Dockerfile from the root directory of the repository (For example: ./folder/Dockerfile)?

[starryacat]

I attempted to perform further testing by installing Quickstack fresh on Ubuntu 24.04.4 LTS (on Multipass, arm64 macOS / 4 CPU, 8 GiB Memory, 20 GiB Disk), but encountered the error.

The configuration is as shown in the photo below the log.

(I'm not sure if this error relates to this issue, but since the same actions produced a different error, I'm reporting it here. Perhaps it's due to an update?)

Error Log:

Stream opened, loading build logs...

-----------------------------------------------
 Deployment:   4d5dfb7e-d45e-4086-8387-cd86b135b301
 App:          app-test-62e95a51
 Project:      proj-t-57ff4b36
-----------------------------------------------
[2026-03-07T06:39:44.162Z]: Initialized app build...
[2026-03-07T06:39:44.162Z]: Trying to clone repository...
[2026-03-07T06:39:44.939Z]: Cloned repository successfully
[2026-03-07T06:39:44.939Z]: Latest remote git hash: 905c191203f4c4485f67558590b5b6f629c2f8d2
[2026-03-07T06:39:44.939Z]: Creating build job with name: build-app-test-62e95a51-8ded60ba
[2026-03-07T06:39:44.939Z]: Dockerfile context path: root directory of Git Repository. Dockerfile name: Dockerfile
[2026-03-07T06:39:44.954Z]: Build job build-app-test-62e95a51-8ded60ba started successfully
2026-03-07T06:39:46.125537174Z #1 [internal] load remote build context
2026-03-07T06:39:46.505994625Z #1 DONE 0.5s
2026-03-07T06:39:46.572869849Z 
2026-03-07T06:39:46.572886473Z #1 [internal] load remote build context
2026-03-07T06:39:46.572887598Z #1 DONE 0.5s
2026-03-07T06:39:46.574060615Z context:7
2026-03-07T06:39:46.574066364Z --------------------
2026-03-07T06:39:46.574067448Z    5 |     
2026-03-07T06:39:46.574068073Z    6 |     
2026-03-07T06:39:46.574069031Z    7 | >>> <!DOCTYPE html>
2026-03-07T06:39:46.574069614Z    8 |     <html
2026-03-07T06:39:46.574070281Z    9 |       lang="en"
2026-03-07T06:39:46.574070864Z --------------------
2026-03-07T06:39:46.574071864Z error: failed to solve: dockerfile parse error on line 7: unknown instruction: <!DOCTYPE
[2026-03-07T06:39:49.984Z]: [END] Log stream ended for build process: build-app-test-62e95a51-8ded60ba

Configuration:

P.S. This error persisted even when I left the GitHub username and token fields blank in the configuration, or entered only the username.

[biersoeckli]

QuickStack expects the HTTPS Git clone URL (including the .git suffix for some platforms like Github or Gitlab). Sometimes the normal repository page URL (without the .git suffix) doesn't work:

• This works--> https://github.com/biersoeckli/dummy-node-app.git
• This does not work--> https://github.com/biersoeckli/dummy-node-app

That could also be the issue of your first error: #67 (comment)

I have added a validation check for this in a new PR to prevent this issue in the future: #71

Additionally, when running QuickStack it is recommended to have at least 40 GB of server storage. If your server has less than 40 GB storage, the system may run out of storage during the build process and the OS may terminate the build.

[starryacat]

Adding the .git suffix to the URL resolved both issues, allowing the app to deploy successfully. Thank you for your prompt response.

Regarding storage, since it was just a test, I didn't allocate much space, but perhaps I should have.

Anyway, thank you very much.

[biersoeckli]

Great, if there are any further questions/issues, just create a new issue here.