{"id":19100,"date":"2024-08-22T17:32:40","date_gmt":"2024-08-22T21:32:40","guid":{"rendered":"https:\/\/carleton.ca\/scs\/?p=19100"},"modified":"2026-06-23T16:48:34","modified_gmt":"2026-06-23T20:48:34","slug":"ssh-connection-with-turbovnc","status":"publish","type":"post","link":"https:\/\/carleton.ca\/scs\/2024\/ssh-connection-with-turbovnc\/","title":{"rendered":"SSH Connection with TurboVNC"},"content":{"rendered":"\n<section class=\"w-screen px-6 cu-section cu-section--white ml-offset-center md:px-8 lg:px-14\">\n    <div class=\"space-y-6 cu-max-w-child-5xl  md:space-y-10 cu-prose-first-last\">\n\n            <div class=\"cu-textmedia flex flex-col lg:flex-row mx-auto gap-6 md:gap-10 my-6 md:my-12 first:mt-0 max-w-5xl\">\n        <div class=\"justify-start cu-textmedia-content cu-prose-first-last\" style=\"flex: 0 0 100%;\">\n            <header class=\"font-light prose-xl cu-pageheader md:prose-2xl cu-component-updated cu-prose-first-last\">\n                                    <h1 class=\"cu-prose-first-last font-semibold !mt-2 mb-4 md:mb-6 relative after:absolute after:h-px after:bottom-0 after:bg-cu-red after:left-px text-3xl md:text-4xl lg:text-5xl lg:leading-[3.5rem] pb-5 after:w-10 text-cu-black-700 not-prose\">\n                        SSH Connection with TurboVNC\n                    <\/h1>\n                \n                                \n                                    \n\n<p>Remote Desktop Client for connecting to OpenStack instances<\/p>\n\n\n                            <\/header>\n\n                    <\/div>\n\n            <\/div>\n\n    <\/div>\n<\/section>\n\n\n\n\n<div class=\"w-full max-w-xl mx-auto overflow-hidden bg-white rounded-lg shadow-lg cu-stackedlist cu-component not-contained not-prose\">\n    <h2 class=\"px-6 py-4 text-base font-semibold border-b rounded-t-lg md:text-xl bg-gray-50 text-cu-black-800\">\n        Table of Contents\n    <\/h2>\n    <div class=\"grid cu-scrollto cu-stackedlist--toc cu-stackedlist--1 md:grid-cols-1\">\n            <div class=\"space-y-1\">\n                    \n            <div class=\"pl-4 text-cu-red-700\">\n                <div class=\"flex gap-2 pb-3 text-base md:text-lg\">\n                    <span class=\"font-light text-cu-black-700\">\n                        1.\n                    <\/span>\n\n                    <a href=\"#step-1-download-turbovnc-client-for-your-os\" class=\"font-medium hover:underline\">\n                        Step 1: Download TurboVNC Client for your OS\n                    <\/a>\n                <\/div>\n\n                            <\/div>\n                    \n            <div class=\"pl-4 text-cu-red-700\">\n                <div class=\"flex gap-2 pb-3 text-base md:text-lg\">\n                    <span class=\"font-light text-cu-black-700\">\n                        2.\n                    <\/span>\n\n                    <a href=\"#install-turbovnc\" class=\"font-medium hover:underline\">\n                        Step 2: Install the TurboVNC Client\n                    <\/a>\n                <\/div>\n\n                            <\/div>\n                    \n            <div class=\"pl-4 text-cu-red-700\">\n                <div class=\"flex gap-2 pb-3 text-base md:text-lg\">\n                    <span class=\"font-light text-cu-black-700\">\n                        3.\n                    <\/span>\n\n                    <a href=\"#connect-with-turbovnc\" class=\"font-medium hover:underline\">\n                        Step 3: Open a TurboVNC desktop connection\n                    <\/a>\n                <\/div>\n\n                            <\/div>\n                    \n            <div class=\"pl-4 text-cu-red-700\">\n                <div class=\"flex gap-2 pb-3 text-base md:text-lg\">\n                    <span class=\"font-light text-cu-black-700\">\n                        4.\n                    <\/span>\n\n                    <a href=\"#optional-reconnect-to-a-turbovnc-session\" class=\"font-medium hover:underline\">\n                        Optional: Reconnect to a TurboVNC Session\n                    <\/a>\n                <\/div>\n\n                            <\/div>\n                    \n            <div class=\"pl-4 text-cu-red-700\">\n                <div class=\"flex gap-2 pb-3 text-base md:text-lg\">\n                    <span class=\"font-light text-cu-black-700\">\n                        5.\n                    <\/span>\n\n                    <a href=\"#bug-turbovnc-window-manager\" class=\"font-medium hover:underline\">\n                        BUG: TurboVNC connections will fail after an update\n                    <\/a>\n                <\/div>\n\n                            <\/div>\n            <\/div>\n\n    <\/div>\n<\/div>\n\n\n\n<p>Our OpenStack images that include desktops are preconfigured to run the turbovnc server. This server allows you to connect to your OpenStack instance using the TurboVNC client, which provides a very fast and secure desktop environment.<\/p>\n\n\n\n<h2 id=\"step-1-download-turbovnc-client-for-your-os\" class=\"wp-block-heading\">Step 1: Download TurboVNC Client for your OS<\/h2>\n\n\n\n<p>Download TurboVNC: <a href=\"https:\/\/github.com\/TurboVNC\/turbovnc\/releases\">TurboVNC Releases Download Page<\/a>.  Find the package for your computer&#8217;s operating system (OS)<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>For macOS on M-series chips, select the <strong>TurboVNC-<em>version_number<\/em>&#8211;<\/strong><strong style=\"color: red;\">arm64.dmg<\/strong><\/li>\n\n\n\n<li>For macOS on Intel chips, select the <strong>TurboVNC-<em>version_number<\/em>&#8211;<\/strong><strong style=\"color: red;\">x86_64.dmg<\/strong><\/li>\n\n\n\n<li>For Windows 64-bit (most cases), select the <strong>TurboVNC-<em>version_number<\/em>&#8211;<\/strong><strong style=\"color: red;\">x64.exe<\/strong><\/li>\n\n\n\n<li>For Windows 32-bit (old devices), select the <strong>TurboVNC-<em>version_number<\/em>&#8211;<\/strong><strong style=\"color: red;\">x86.exe<\/strong><\/li>\n\n\n\n<li>For Linux, you can select a suitable source file, rpm package, etc<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"install-turbovnc\">Step 2: Install the TurboVNC Client<\/h2>\n\n\n\n<p>Install the TurboVNC client that you downloaded.  In macOS and Windows, this should be as easy double-clicking on the installer file that you downloaded in the previous step.<br>\n<strong>Some Important Notes:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>On Windows 11, the TurboVNC client does not automatically setup start-menu or desktop shortcuts to access the tool.  The easiest way to open it is to click on the Windows <strong>Start<\/strong> button, and then type <em>TurboVNC<\/em> in the search bar.  The <strong>TurboVNC Viewer App<\/strong> will appear under the <em>Best Match<\/em> list.  If you <em>Right-click<\/em> on the icon, it will give you the option to <em>Pin to Start<\/em>.  This can make it easier to find in the future.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"connect-with-turbovnc\">Step 3: Open a TurboVNC desktop connection<\/h2>\n\n\n\n<p><em class=\"myprefix-text-italic\"><strong class=\"myprefix-text-bold\">NOTE<\/strong>: TurboVNC cannot be used to connect to our instances for the first time as it does not support the first logon password reset. See<strong class=\"myprefix-text-bold\"> Login Credentials &amp; First Login<\/strong> below for more information<\/em><\/p>\n\n\n\n<p>Open the <strong>TurboVNC<\/strong> client app. You will see a windows similar to this:<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter\"><img loading=\"lazy\" decoding=\"async\" width=\"438\" height=\"147\" src=\"https:\/\/carleton.ca\/scs\/wp-content\/uploads\/sites\/260\/turbovnc-client-connection.png\" alt=\"\" class=\"wp-image-19116\" srcset=\"https:\/\/carleton.ca\/scs\/wp-content\/uploads\/sites\/260\/turbovnc-client-connection.png 438w, https:\/\/carleton.ca\/scs\/wp-content\/uploads\/sites\/260\/turbovnc-client-connection-160x54.png 160w, https:\/\/carleton.ca\/scs\/wp-content\/uploads\/sites\/260\/turbovnc-client-connection-240x81.png 240w, https:\/\/carleton.ca\/scs\/wp-content\/uploads\/sites\/260\/turbovnc-client-connection-400x134.png 400w, https:\/\/carleton.ca\/scs\/wp-content\/uploads\/sites\/260\/turbovnc-client-connection-360x121.png 360w\" sizes=\"auto, (max-width: 438px) 100vw, 438px\" \/><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Fill in the <strong>VNC server<\/strong> field to be the format <strong>username@floating-ip-address<\/strong> <em>(see the Login Credentials below for information about your username and password)<\/em><\/li>\n\n\n\n<li>Click the <strong>Connect<\/strong> button<\/li>\n\n\n\n<li>Enter your <strong>Password<\/strong> when prompted<\/li>\n\n\n\n<li>That&#8217;s it!  In a few seconds a window should open showing your desktop connection, similar to the image below<\/li>\n<\/ul>\n\n\n\n<section class=\"w-screen px-6 cu-section cu-section--white ml-offset-center md:px-8 lg:px-14\">\n    <div class=\"space-y-6 cu-max-w-child-5xl  md:space-y-10 cu-prose-first-last\">\n\n        \n    \n    <dl class=\"cu-description cu-component-updated\">\n        \n    <div class=\"grid pt-4 pb-3 border-b accordion border-cu-black-100 md:pt-6 md:pb-5 first:border-t\">\n        <dt class=\"font-semibold not-prose\">\n            <button class=\"flex items-center justify-between w-full text-left accordion__button\" aria-expanded=\"false\" aria-controls=\"accordion-login-credentials-and-first-login\">\n                <span class=\"flex-1 ml-auto text-left break-words whitespace-normal cu-icon\">\n                    Login Credentials and First Login\n                <\/span>\n                <svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" fill=\"none\" viewbox=\"0 0 24 24\" stroke-width=\"1.5\" stroke=\"currentColor\" aria-hidden=\"true\" data-slot=\"icon\" class=\"w-5 h-5 ml-auto transition-transform rotate-0 accordion__icon text-cu-black-500\">\n                    <path stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M8.25 4.5l7.5 7.5-7.5 7.5\"><\/path>\n                <\/svg>\n            <\/button>\n        <\/dt>\n        <dd class=\"p-0 mt-0 cu-prose cu-prose-first-last accordion__content md:p-0 md:mt-0\" hidden=\"\" id=\"accordion-login-credentials-and-first-login\">\n            \n\n<p><br><strong>Login Credentials:<\/strong>&nbsp;<em>Most<\/em>&nbsp;of our OpenStack images share the same default credentials:<br><strong>username:&nbsp;<em>student<\/em><\/strong><br><strong>password:&nbsp;<em>student<\/em><\/strong><\/p>\n\n\n\n<p><strong>IMPORTANT:<\/strong>&nbsp;New images since (<strong>2022\/2023<\/strong>)&nbsp;<strong>force a password change<\/strong>&nbsp;on the first login.<br><strong>First Login Scenarios:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>TurboVNC WARNING:<\/strong>&nbsp;TurboVNC does&nbsp;<strong>NOT<\/strong>&nbsp;support first login password changes, so your first login must use another login tool below<\/li>\n\n\n\n<li><strong>vscode WARNING:<\/strong>&nbsp;vscode does&nbsp;<strong>NOT<\/strong>&nbsp;support first login password changes, so your first login must use another login tool below<\/li>\n\n\n\n<li><strong>ssh terminal (putty, etc)<\/strong>&nbsp;first login: When you login, you will be redirect to a change password prompt. You will then have to enter the current password (student) again, and then enter your new password twice. When you change your password, it will then log you out and you have to login again with that new password<\/li>\n\n\n\n<li><strong>x2go<\/strong>&nbsp;first login: When you login, you will be redirect to a change password prompt. You will then have to enter the current password (student) again, and then enter your new password twice. When you change your password, it will then prompt you to&nbsp;<em>click reconnect<\/em>, at which point you can login again using the new password<\/li>\n\n\n\n<li><strong>openstack web console<\/strong>&nbsp;first login: When you login, you will be redirect to a change password prompt. You will then have to enter the current password (student) again, and then enter your new password twice. In this case, you stay connected. The next time you login, you will need the new password<\/li>\n<\/ul>\n\n\n\n<p><strong>WARNING:<\/strong>&nbsp;If you are using an older image (pre-2022) that does not enforce an ssh key or a password change, then we strongly encourage you to immediately change your password or setup an ssh key!<\/p>\n\n\n        <\/dd>\n    <\/div>\n\n\n    <\/dl>\n\n\n    <\/div>\n<\/section>\n\n\n\n<p><strong class=\"myprefix-text-bold\">Example TurboVNC Desktop Window<\/strong>: Your TurboVNC Desktop Windows should look similar to the image below:<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter\"><img loading=\"lazy\" decoding=\"async\" width=\"947\" height=\"572\" src=\"https:\/\/carleton.ca\/scs\/wp-content\/uploads\/sites\/260\/turbovnc-client-desktop.png\" alt=\"\" class=\"wp-image-19120\" srcset=\"https:\/\/carleton.ca\/scs\/wp-content\/uploads\/sites\/260\/turbovnc-client-desktop.png 947w, https:\/\/carleton.ca\/scs\/wp-content\/uploads\/sites\/260\/turbovnc-client-desktop-160x97.png 160w, https:\/\/carleton.ca\/scs\/wp-content\/uploads\/sites\/260\/turbovnc-client-desktop-240x145.png 240w, https:\/\/carleton.ca\/scs\/wp-content\/uploads\/sites\/260\/turbovnc-client-desktop-768x464.png 768w, https:\/\/carleton.ca\/scs\/wp-content\/uploads\/sites\/260\/turbovnc-client-desktop-400x242.png 400w, https:\/\/carleton.ca\/scs\/wp-content\/uploads\/sites\/260\/turbovnc-client-desktop-360x217.png 360w\" sizes=\"auto, (max-width: 947px) 100vw, 947px\" \/><\/figure>\n\n\n\n<h2 id=\"optional-reconnect-to-a-turbovnc-session\" class=\"wp-block-heading\">Optional: Reconnect to a TurboVNC Session<\/h2>\n\n\n\n<p>If you want to reconnect to a TurboVNC session, you can simply close the TurboVNC window, without actually logging out of the desktop.  This will save your session for you to connect to at a later time.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>If you have a TurboVNC session already running when you connect, you will see an additional window after the password prompt<\/li>\n\n\n\n<li>To <strong>reconnect to a previous session<\/strong>, click the <strong>Connect<\/strong> button next to the appropriate session (there could be more than one)<\/li>\n\n\n\n<li>To <strong>start a new session<\/strong>, click the <strong>New Session<\/strong> button.<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image aligncenter\"><img loading=\"lazy\" decoding=\"async\" width=\"444\" height=\"121\" src=\"https:\/\/carleton.ca\/scs\/wp-content\/uploads\/sites\/260\/turbovnc-client-newsession-or-reconnect.png\" alt=\"\" class=\"wp-image-19122\" srcset=\"https:\/\/carleton.ca\/scs\/wp-content\/uploads\/sites\/260\/turbovnc-client-newsession-or-reconnect.png 444w, https:\/\/carleton.ca\/scs\/wp-content\/uploads\/sites\/260\/turbovnc-client-newsession-or-reconnect-160x44.png 160w, https:\/\/carleton.ca\/scs\/wp-content\/uploads\/sites\/260\/turbovnc-client-newsession-or-reconnect-240x65.png 240w, https:\/\/carleton.ca\/scs\/wp-content\/uploads\/sites\/260\/turbovnc-client-newsession-or-reconnect-400x109.png 400w, https:\/\/carleton.ca\/scs\/wp-content\/uploads\/sites\/260\/turbovnc-client-newsession-or-reconnect-360x98.png 360w\" sizes=\"auto, (max-width: 444px) 100vw, 444px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"bug-turbovnc-window-manager\">BUG: TurboVNC connections will fail after an update<\/h2>\n\n\n\n<p>If TurboVNC is updated on your instance, you may have a situation where connections from the TurboVNC client subsequently fail.  This is caused by a bug where TurboVNC is unable to identify the proper Linux Window Manager being used on your instance. <\/p>\n\n\n\n<p><strong class=\"myprefix-text-bold\">Solution:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Use an ssh terminal session to connect to your instance<\/li>\n\n\n\n<li>On the instance, open the file: <code>\/etc\/turbovncserver.conf<\/code> and add the line <code>$wm = \"xfce\";<\/code> to the end of the file. Close the file and save it<\/li>\n\n\n\n<li>Attempt to connect to the instance using your TurboVNC client<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"<p>Our OpenStack images that include desktops are preconfigured to run the turbovnc server. This server allows you to connect to your OpenStack instance using the TurboVNC client, which provides a very fast and secure desktop environment. Step 1: Download TurboVNC Client for your OS Download TurboVNC: TurboVNC Releases Download Page. Find the package for your [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":19120,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":"","_links_to":"","_links_to_target":""},"categories":[61,58,99,57,1],"tags":[],"class_list":["post-19100","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-linux-tech-support","category-openstack-support","category-ssh","category-technicalsupport","category-uncategorized"],"acf":{"cu_post_thumbnail":""},"_links":{"self":[{"href":"https:\/\/carleton.ca\/scs\/wp-json\/wp\/v2\/posts\/19100","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/carleton.ca\/scs\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/carleton.ca\/scs\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/carleton.ca\/scs\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/carleton.ca\/scs\/wp-json\/wp\/v2\/comments?post=19100"}],"version-history":[{"count":4,"href":"https:\/\/carleton.ca\/scs\/wp-json\/wp\/v2\/posts\/19100\/revisions"}],"predecessor-version":[{"id":25235,"href":"https:\/\/carleton.ca\/scs\/wp-json\/wp\/v2\/posts\/19100\/revisions\/25235"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/carleton.ca\/scs\/wp-json\/wp\/v2\/media\/19120"}],"wp:attachment":[{"href":"https:\/\/carleton.ca\/scs\/wp-json\/wp\/v2\/media?parent=19100"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/carleton.ca\/scs\/wp-json\/wp\/v2\/categories?post=19100"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/carleton.ca\/scs\/wp-json\/wp\/v2\/tags?post=19100"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}