Giter Club home page Giter Club logo

rport-guacamole's Introduction

Pre-compiled Guacamole Proxy Daemon packages

The repository contains instructions how to compile the Guacamole Proxy Daemon guacd to be used by the rport server.

It also contains ready-to-use packages for

Distribution  Version Architectures
Debian  11 (bullseye)  x86_64 aarch64 armv7l
Debian 10 (buster)   x86_64 aarch64 armv7l
Ubuntu 20.04 (focal)  x86_64 aarch64 amrv7l
Ubuntu 18.04 (bionic)  x86_64

🚫 Do not use any of the above packages to build a fully featured Guacamole Server!

The packages are only suitable to run in combination with rportd.

Install packages on Debian

To install the Guacamole Proxy Daemon from pre-compiled packages, proceed as follows.

# Resolve dependencies first
apt install libcairo2 libjpeg62-turbo libpng16-16 libwebp6 libfontconfig1 libfreetype6 libfreerdp-client2-2 libssh2-1
# Download the package
. /etc/os-release
curl -LO https://bitbucket.org/cloudradar/rport-guacamole/downloads/rport-guacamole_1.4.0_debian_${VERSION_CODENAME}_$(uname -m).deb
# Install
dpkg -i rport-guacamole_1.4.0_debian_${VERSION_CODENAME}_$(uname -m).deb

Install packages on Ubuntu

To install the Guacamole Proxy Daemon from our pre-compiled packages, proceed as follows.

# Resolve dependencies first
apt install libcairo2 libjpeg-turbo8 libpng16-16 libwebp6 libfontconfig1 libfreetype6 libfreerdp-client2-2 libssh2-1
# Download the package
. /etc/os-release
curl -LO https://bitbucket.org/cloudradar/rport-guacamole/downloads/rport-guacamole_1.4.0_ubuntu_${VERSION_CODENAME}_$(uname -m).deb
# Install
dpkg -i rport-guacamole_1.4.0_ubuntu_${VERSION_CODENAME}_$(uname -m).deb

To avoid conflicts with a potentially already running instance of guacd it's installed to /opt/rport-guacamole. By default, guacd listens only on localhost port 9445. To change the port, edit /etc/default/rport-guacamole.

Compile and package yourself

If you prefer to compile and package yourself, just execute the scripts of the repository on your machine.

To compile and build the Debian packages fastly, proceed as shown below.

export DEBIAN_FRONTEND=noninteractive
git clone https://[email protected]/cloudradar/rport-guacamole.git
cd port-guacamole
sh 01-resolve-debian-dependencies.sh
sh 02-compile-guacamole.sh
sh 03-create-deb.sh
sh 04-lintian.sh

Popular pitfalls

If you compile yourself, heed the following advice:

  • guacd writes some files on the fly into $HOME. Not all users have a writable home directory. The user daemon for example, cannot write files to $HOME.
  • The guacd sometimes can't find the needed rdp libraries. Pass the library path when starting.

Example:

HOME=/tmp LD_LIBRARY_PATH=/opt/rport-guacamole/lib /opt/rport-guacamole/sbin/guacd -v

The pre-compiled packages ship with a systemd service that does all the above in the background.

License

The Apache Guacamole™ source code is released under the Apache License, Version 2.0.

Liability disclaimer

⚠️ Use the instructions or the pre-compiled packages at your own risk.

This repository is not part of the Apache Guacamole™ project.

Notes

  • The x86_64 packages and binaries are compiled and packaged on the Bitbucket pipeline using the official docker images of the respective distributions.
  • The aarch packages and binaries are compiled and packaged on the Oracle Cloud using the LXD containers of the respective distributions.
  • The armv7l packages and binaries are compiled and packaged on a Odroid HC1 using the LXC containers of the respective distributions.

rport-guacamole's People

Contributors

thorstenkramm avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.