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

CLI install docs should prefer omnibus packages over gem install #31

Open
SpComb opened this issue Oct 9, 2017 · 3 comments
Open

CLI install docs should prefer omnibus packages over gem install #31

SpComb opened this issue Oct 9, 2017 · 3 comments

Comments

@SpComb
Copy link
Contributor

SpComb commented Oct 9, 2017

The Quick Start docs only link to the omnibus release packages for OSX, but these are now also available as Debian/Ubuntu deb packages for the 1.4 release. The docs for Linux should be updated to prefer the omnibus deb package over a manual gem install.

Problems with the manual gem install:

It's still unclear what we should do about Windows, because we don't have a omnibus packages for that platform (kontena/kontena#2307). Should we recommend Windows Subsystem for Linux + the deb package for Windows 10, or do the windows ruby distributions include the necessary compiler + ruby-dev stuff to install native extensions?

@SpComb
Copy link
Contributor Author

SpComb commented Oct 9, 2017

For Ubuntu, signed CLI packages are also available on bintray as an APT repository. Downloading and installing the deb is easier and faster for new users, but the signed packages from the APT repo are better for long-term use.

@jakolehm
Copy link
Contributor

jakolehm commented Oct 9, 2017

I think we should recommend WSFL for Windows users and instruct Ruby + gem just as a fallback if user cannot use WSFL.

@jakolehm
Copy link
Contributor

jakolehm commented Oct 9, 2017

Docs also link now just to Github release page which is not very user friendly. Maybe we could provide some wrapper (microservice) that allows user to download latest omnibus package directly?

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

No branches or pull requests

2 participants