/lens

LibreLens - OpenSource Kubernetes Management Platform

Primary LanguageTypeScriptMIT LicenseMIT

LibreLens (an OpenLens fork)

This repository is a direct fork of the famous OpenLens project that includes binary builds for every stable or release version.

Why is a fork necessary?

As of today, Mirantis, the main developers behind Lens only release a propritary version of Lens on their Website. While LibreLens can not provide any nameful support, it still offers many advantages compared to the Mirantis business solution:

  • The propritary version requires LensID and your agreement to their Terms of Service. This open source build is MIT licensed and allows you to do with it whatever you want.
  • The propritary version adds additional features that you may want to have, especially if collaborating with a team. This open source build does only include the features that are not also included in this repository.
  • The proprietary version follows a subscription model that allows Mirantis to support your exact needs. This open source build provides you with a tool and that's it. No business support, no cost, no terms of service.

Install Lens

  • go to the releases page
  • download the binary for your system and use your default install procedure.

Packages are not code signed which may be a problem on Windows or Mac computers if you are not able to elevate priviledges. For code signed packages, a mac/windows developer account is neccessary. If you are able to provide the necessary resources for code signing, please let me know in the respective issue for windows or mac

You can also have a look at https://github.com/MuhammedKalkan/OpenLens, which is the original inspiration of the github actions.

Build Lens on your own system

the following instructions are heavily inspired by github user jslay88

Mac

Install Dependencies
Build and Install LibreLens
# set up node 14 and yarn
nvm install 14
nvm use 14
npm install -g yarn

# build LibreLens
https://github.com/LibreLens/lens.git
cd lens
make build

# install LibreLens
cp -Rfp dist/mac/OpenLens.app ~/Applications/

Windows

Install Dependencies
  • choco install make visualstudio2019buildtools visualstudio2019-workload-vctools
  • nvm for windows
Build and Install LibreLens
# set up node 14 and yarn
nvm install 14
nvm use 14
npm install -g yarn

# build LibreLens
https://github.com/LibreLens/lens.git
cd lens
make build

# install LibreLens
start ./dist/'LibreLens Setup <your-version>.exe'

Debian-based systems

  • sudo apt-get install -y g++ make curl git
  • nvm
Install Dependencies
Build and Install LibreLens
# set up node 14 and yarn
nvm install 14
nvm use 14
npm install -g yarn

# build LibreLens
https://github.com/LibreLens/lens.git
cd lens
make build

# install LibreLens
sudo dpkg -i dist/OpenLens-<your-version>.deb

Disclaimer

This software is provided "as is". In no event shall the authors, maintainers and copyright holders be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.