[📖] Provide a general deployment page for self-hosters

[christian-hackyourshack]

Suggestion

I think there are some common issues, that new users are facing, when trying to deploy a Qwik app to their own infrastructure independent of using Node, Deno or Bun. Hence, I want to suggest to merge those deployment pages together, remove the sentence "Since you are choosing [Node|Deno|Bun], here you are in your own..." and try to collect the common issues, that usually do not result from the server technology but from the hosting infrastructure.

For me it was:

• set ORIGIN because my server runs behind a proxy handling SSL, that is currently only mentioned for Node, but not for Deno and Bun (probably not necessary for Deno Deploy, but if self-hosted)
• default minification of HTML on the Cloudflare edge, stripping out the essential HTML comments, but there is no hint in the docs, that the comments are essential

I would love to use this issue for a discussion, potentially collecting more issues encountered by others and when considered good, I would create a PR for the docs pages.

[christian-hackyourshack]

I created a Discord thread for qwik discussions:
https://discord.com/channels/842438759945601056/842438761287254019/1172118644508078081

[ptz0n]

Thank you so much for pointing this out. I was struggling to understand why my client side routing was broken. Everything else worked fine, no errors in console or Network tab.

Here's my POC: https://github.com/ptz0n/qwik-cloudfront-s3-lambda-url

[christian-hackyourshack]

One more point would be, what to put into a docker. Currently it seems, as if you need to put node_modules into the docker, too, which is not obvious and very inefficient. But I have not dockerized any other Vite-based SSR projects yet, so that might be normal.

Because I like it tidy, I would prefer a solution, where I can get a tree-shaken version for the server, too. Right now, I am uploading a 350MB docker to my server, where the biggest memory-hogs are @qwikest/icons (55MB), where I use 5 icons and typescript (40MB), which should not be required at runtime at all followed by other dependencies like prettier (9MB), esbuild (9MB), ...

[gioboa]

This cookbook described a Deploy with Node using Docker scenario. Do you think is enough? @christian-hackyourshack

[christian-hackyourshack]

I like your cookbook and I saw, that the ORIGIN has made it into it and also into the deployment docs for node.

I still think the minification should still get a mention somewhere, because it is not really clear from the docs, how Qwik uses inline comments for its implementation. And when you integrate it into your CI/CD this might be an important detail. For Cloudflare it might be less interesting now, as they changed the default setting to not minify anymore.

[gioboa]

would you like to improve that page with your suggestions? It will be great. Thanks

[iitzIrFan]

@gioboa @maiieul @wmertens

I had seen issue since long and was working on it for some time and thought of sharing my work as it is completed now.

So I,
- Created a new documentation section for this where I wrote the Prerequisites, Build options, methods of deployment, server config, CSRF protection guidelines and some practices for better performance along with troubleshooting guidance.

Video for reference :-

2025-03-25.01-49-47.mp4

Give conformation to make an PR for this.
Thank you !

[iitzIrFan]

@maiieul @gioboa @wmertens

Had made an PR which solves this issue which can be reviewed by the maintainers and any further revisions are welcome.
Thank you !

PR Link :- #7458