Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Rework or drop source installation instructions because it doesn't work (at least for the tested scenario) #581

Open
ralf401 opened this issue Nov 25, 2024 · 5 comments

Comments

@ralf401
Copy link
Contributor

ralf401 commented Nov 25, 2024

In case of reworking the instructions, at least the following points should be checked for Ubuntu Server 24.04:

  • Add command for adding user to rvm group
  • Investigate which command has to be executed as which user
  • Investigate if there is another possibility than add sudo group to user zammad.
  • Check why adding rails environment variables doesn't work from a different user than zammad (even with sudo)
  • TBD
@ralf401
Copy link
Contributor Author

ralf401 commented Nov 25, 2024

@YetAnotherGerrit & @mgruner: I tried to install Zammad again from source and it doesn't work if you just follow the documentation. Even if you are using a plain Ubuntu... And we have 3/4 different distros to cover, this is barely maintainable. I recommend to think again about dropping the source installation instructions. If internally needed, we could move it to the knowledgebase, Gitlab or another appropriate place.

Feel free to disagree. But in my eyes the effort is high and the outcome is very small.

@YetAnotherGerrit
Copy link
Contributor

I agree that from source installation is something rarely used in production. But we need to make sure to not close the doors to open-source development enthusiasts. Maybe we can join it somehow with the "how to contribute" manual, so someone who wants to contribute as a developer can get a dev env up and running?

@ralf401
Copy link
Contributor Author

ralf401 commented Nov 26, 2024

But we need to make sure to not close the doors to open-source development enthusiasts. Maybe we can join it somehow with the "how to contribute" manual, so someone who wants to contribute as a developer can get a dev env up and running?

I don't think we are closing any doors by dropping it. There is a developer manual on Github where people can find detailed installation instructions (see How to set up a development environment). This development guide is even linked in the zammad repo README.md.

So my suggestion is to temporarily link to this Github developer manual from the source installation page and add it to the contribution section. After the next release we can remove the souce installation page from the documentation.

Any objections?

@YetAnotherGerrit
Copy link
Contributor

I talked with several stakeholders, no veto from my side. Thank you for taking care!

@ralf401
Copy link
Contributor Author

ralf401 commented Nov 27, 2024

Note: preserve an archive branch

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants