[Feature Request] Provide documentation or links to documentation how to deploy CSS on a production server

[phochste]

Feature description

It is easy to run an CSS server for development purposes and this is well documented in the project. But, the documentation how to deploy a CSS server on a production server requires quite a lot of searching through (closed) tickets 1580, deeply hidden in the templates, personal communication or in (internal) project websites.

It would be very helpful to provide hints how to setup CSS as reverse proxy for a Apache or Nginx as part of the documentation or at least provide in the CSS documentation links ( Apache Nginx ) to websites that provide this information.

[joachimvh]

Was the linked documentation sufficient or was there something missing? If yes, what would need to be added? If they're fine we can just link them from the CSS documentation.

[phochste]

The linked documentation provides a step further towards a production installation. They are hints on how production configuration could look like (how to get it actually running system could be different ..like in my case on Ubuntu 20).

What needs to be added is some governance in general on how this information is kept up to date (but this is with any project).

It would be helpful to link them from the CSS documentation. I wouldn't have guessed where else to start searching for this type of information.

[gjwgit]

Just in case this is useful, I've been capturing some notes re setting up CSS on cloud servers running Caddy (rather than Apache/Nginx). I'm no expert but it's been working nicely on a couple of public servers we have for app development and deployment. It probably needs a careful review, but it's pretty straight forward on a new Ubuntu 23.10 server to running CSS v7.0.2. Hopefully it looks about right.

https://survivor.togaware.com/gnulinux/css-public-setup.html

[phochste]

@gjwgit certainly useful. Do you also have hints how the WebSockets of CSS can be made available via the proxy?

[ewingson]

@phochste

just in case / or in doubt if it is helpful.
I run CSS with underlying Nginx/reverse proxy for quite some time now, do version and certs updates and took some notes.

you find them here https://gist.github.com/ewingson/2f92858f97e8043ded41cc87bc82b4d1
and here https://gist.github.com/ewingson/dbfee4d329c803aed0b0bd87e7a2fa00

[mrkvon]

I wrote detailed instructions how to set up CSS with Debian, nginx, pm2, mashlib. Any feedback much appreciated.

https://github.com/mrkvon/css-setup

[phochste]

@mrkvon This is a very complete setup. Would love to see links to these projects documented.