blob: 6eb4d05450c8e07e4416f717475d3613336b016f [file] [log] [blame]
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<link rel="stylesheet" href="/styles/main.css?s=1714581448">
<link rel="icon" type="image/svg+xml" href="/images/logos/guac-classic-logo.svg"/>
<link rel="icon" type="image/png" href="/images/logos/guac-classic-logo-64.png"/>
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0, user-scalable=no, target-densitydpi=device-dpi"/>
<meta charset="UTF-8"/>
<title>Apache Guacamole™: 0.9.3</title>
</head>
<body class="">
<!-- Header -->
<div id="header">
<div class="readable-content">
<h1><a href="/">Apache Guacamole™</a></h1>
<ul id="navigation" class="menu">
<li>
<a href="/releases/"
class="releases"
>Release Archives</a>
</li>
<li class="dropdown">
<a class="dropdown-toggle "
href="#">Documentation</a>
<ul class="dropdown-menu">
<li>
<a href="/faq/"
>FAQ</a>
</li>
<li>
<a href="/api-documentation/"
>API / Development</a>
</li>
<li>
<a href="/doc/gug/"
>Guacamole Manual</a>
</li>
</ul>
</li>
<li class="dropdown">
<a class="dropdown-toggle "
href="#">Community</a>
<ul class="dropdown-menu">
<li>
<a href="/open-source/"
>Contributing to Guacamole</a>
</li>
<li>
<a href="/support/#mailing-lists"
>Mailing Lists</a>
</li>
<li>
<a href="https://issues.apache.org/jira/browse/GUACAMOLE/"
>Bug/Issue Tracker</a>
</li>
<li>
<a href="https://github.com/search?utf8=%E2%9C%93&q=repo%3Aapache%2Fguacamole-client+repo%3Aapache%2Fguacamole-server+repo%3Aapache%2Fguacamole-manual+repo%3Aapache%2Fguacamole-website&type=repositories&ref=searchresults"
>Source Code</a>
</li>
</ul>
</li>
<li>
<a href="/security/"
>Security Reports</a>
</li>
<li class="dropdown">
<a class="dropdown-toggle "
href="#">Support</a>
<ul class="dropdown-menu">
<li>
<a href="/support/#mailing-lists"
>Mailing Lists</a>
</li>
<li>
<a href="https://issues.apache.org/jira/browse/GUACAMOLE/"
>Bug/Issue Tracker</a>
</li>
<li>
<a href="/support/#commercial-support"
>Commercial Support</a>
</li>
</ul>
</li>
<li class="dropdown">
<a class="dropdown-toggle apache"
href="#">ASF</a>
<ul class="dropdown-menu">
<li>
<a href="http://www.apache.org/"
>ASF Homepage</a>
</li>
<li>
<a href="http://www.apache.org/licenses/"
>License</a>
</li>
<li>
<a href="http://www.apache.org/foundation/thanks.html"
>Thanks</a>
</li>
<li>
<a href="http://www.apache.org/foundation/sponsorship.html"
>Sponsorship</a>
</li>
<li>
<a href="http://www.apache.org/foundation/policies/conduct.html"
>Code of Conduct</a>
</li>
</ul>
</li>
</ul>
</div>
</div>
<!-- Content -->
<div class="fullwidth-content">
<h1 class="title">
Guacamole 0.9.3
<span class="release-type">
(Legacy)
</span>
</h1>
<div class="readable-content">
<div class="note">
<p><strong>The release below is from prior to Guacamole's acceptance into
the Apache Incubator.</strong> It is not an Apache Software Foundation
release, and is licensed under the <a
href="https://opensource.org/licenses/MIT">MIT license</a>. The latest
release of Apache Guacamole is <a href="/releases/1.5.5/">1.5.5</a>.</p>
</div>
<div id="links">
<!-- Compatible extensions -->
<h2>Compatible extensions</h2>
<ul>
<li><a href="http://downloads.sourceforge.net/project/guacamole/current/extensions/guacamole-auth-ldap-0.9.3.tar.gz">LDAP Authentication</a></li>
<li><a href="http://downloads.sourceforge.net/project/guacamole/current/extensions/guacamole-auth-mysql-0.9.3.tar.gz">MySQL Authentication</a></li>
<li><a href="http://downloads.sourceforge.net/project/guacamole/current/extensions/guacamole-auth-noauth-0.9.3.tar.gz">NoAuth (Disabled) Authentication</a></li>
</ul>
<!-- Binary .war -->
<h2>Web application (.war)</h2>
<ul>
<li><a href="http://downloads.sourceforge.net/project/guacamole/current/binary/guacamole-0.9.3.war">guacamole-0.9.3.war</a></li>
</ul>
<!-- Source archives -->
<h2>Source</h2>
<ul>
<li><a href="http://downloads.sourceforge.net/project/guacamole/current/source/guacamole-client-0.9.3.tar.gz">guacamole-client-0.9.3.tar.gz</a></li>
<li><a href="http://downloads.sourceforge.net/project/guacamole/current/source/guacamole-server-0.9.3.tar.gz">guacamole-server-0.9.3.tar.gz</a></li>
</ul>
<!-- Documentation -->
<h2>Release documentation</h2>
<ul>
<li><a href="/doc/0.9.3/gug">Manual</a></li>
<li><a href="/doc/0.9.3/guacamole-common">guacamole-common</a></li>
<li><a href="/doc/0.9.3/guacamole-common-js">guacamole-common-js</a></li>
<li><a href="/doc/0.9.3/guacamole-ext">guacamole-ext</a></li>
<li><a href="/doc/0.9.3/libguac">libguac</a></li>
</ul>
</div>
<p>The 0.9.3 release of Guacamole features greatly improved keyboard support, the ability to configure guacd with a configuration file, as well as support for authentication via HTTP Basic. Support for all standard control code shortcuts (C0 control codes) within SSH and telnet has also been added. Previous versions of Guacamole only supported Ctrl+A through Ctrl+Z, making other combinations like Ctrl+^ impossible.</p>
<h2 id="configuration-file-for-guacd">Configuration file for guacd</h2>
<p>guacd can now be configured with an INI-style configuration file called guacd.conf. This file is optional, but makes configuring guacd easier when you need custom startup options like SSL encryption or a non-standard port. Past versions of Guacamole required that such options be specified on the command-line.</p>
<ul>
<li>[<a href="https://glyptodon.org/jira/browse/GUAC-813">GUAC-813</a>] - Read configuration files when starting guacd</li>
</ul>
<h2 id="http-basic-authentication">HTTP Basic authentication</h2>
<p>If you use an external service like Apache to provide authentication prior to granting access to the Guacamole login page, you can now pass the username/password from that service through to Guacamole, authenticating with those credentials as if entered on Guacamole’s login page manually.</p>
<p>This requires that the external service use HTTP Basic authentication, but as long as the HTTP “Authorization” header makes its way to Guacamole, it will attempt to authenticate using that first, prior to resorting to the login page.</p>
<ul>
<li>[<a href="https://glyptodon.org/jira/browse/GUAC-693">GUAC-693</a>] - Handle HTTP Basic credentials when authenticating</li>
</ul>
<h2 id="improved-keyboard">Improved keyboard</h2>
<p>After much debugging, the base of Guacamole’s keyboard support has been rewritten to properly handle non-US keyboards. See the links below for a full description of these improvements, but in general, what was broken before is broken no longer. If you were having issues typing with past Guacamole releases, please give 0.9.3 a try and see if things are now resolved.</p>
<ul>
<li>[<a href="https://glyptodon.org/jira/browse/GUAC-659">GUAC-659</a>] - Not all keys work on non-US keyboards</li>
<li>[<a href="https://glyptodon.org/jira/browse/GUAC-850">GUAC-850</a>] - CapsLock not working when connecting via Firefox</li>
</ul>
<h2 id="c0-control-codes">C0 control codes</h2>
<p>Past releases of Guacamole supported Ctrl+A through Ctrl+Z for SSH and telnet, but there are several other standard key combinations which produce control codes from the C0 block. Guacamole 0.9.3 adds support for the remaining codes.</p>
<p>This is particularly important if you use Guacamole to connect to a device that uses these codes to implement “break”, as some Cisco devices do.</p>
<ul>
<li>[<a href="https://glyptodon.org/jira/browse/GUAC-792">GUAC-792</a>] - Add support for C0 control codes to telnet and SSH</li>
</ul>
<h2 id="sound-fixed-in-chrome-and-other-bug-fixes">Sound fixed in Chrome (and other bug fixes)</h2>
<p>Recent versions of Chrome have removed a deprecated sound API that lingered within Guacamole, thus breaking sound. Release 0.9.3 migrates to the newer version of this API, thus restoring sound. If Guacamole is used on a browser that only supports the older API, it will still work.</p>
<ul>
<li>[<a href="https://glyptodon.org/jira/browse/GUAC-793">GUAC-793</a>] - Sound support does not work in recent Chrome</li>
<li>[<a href="https://glyptodon.org/jira/browse/GUAC-775">GUAC-775</a>] - Segfault when using static-channels</li>
<li>[<a href="https://glyptodon.org/jira/browse/GUAC-354">GUAC-354</a>] - Free handlers missing from socket implementations</li>
</ul>
<h2 id="guacamole-protocol-filtering">Guacamole protocol filtering</h2>
<p>If you embed Guacamole within your own web application, and wish to restrict which Guacamole instructions are sent or received over each connection, support for such filtering is now provided within guacamole-common. You can modify, drop, allow, or deny any instruction read/written over an active Guacamole connection.</p>
<ul>
<li>[<a href="https://glyptodon.org/jira/browse/GUAC-868">GUAC-868</a>] - Add protocol filtering to Java API</li>
</ul>
</div>
</div>
<!-- Footer -->
<div id="footer">
<div class="readable-content">
<!-- Copyrights -->
<p class="copyright">
Copyright &copy; 2024 <a href="http://www.apache.org/">The Apache
Software Foundation</a>, Licensed under the <a
href="http://www.apache.org/licenses/LICENSE-2.0">Apache License,
Version 2.0</a>.
</p>
<!-- Trademarks -->
<p class="trademarks">
Apache Guacamole, Guacamole, Apache, the Apache feather logo, and the
Apache Guacamole project logo are trademarks of The Apache Software
Foundation.
</p>
</div>
</div>
<!-- jQuery -->
<script src="/scripts/jquery.min.js" type="text/javascript"></script>
<!-- Dropdown toggle -->
<script src="/scripts/dropdown.js" type="text/javascript"></script>
</body>
</html>