{"id":1436,"date":"2018-12-10T11:15:33","date_gmt":"2018-12-10T11:15:33","guid":{"rendered":"http:\/\/ri.itservices.manchester.ac.uk\/csf3\/?page_id=1436"},"modified":"2026-06-26T12:54:23","modified_gmt":"2026-06-26T11:54:23","slug":"linux-mac","status":"publish","type":"page","link":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/getting-started\/connecting\/linux-mac\/","title":{"rendered":"Logging in from OS-X and Linux"},"content":{"rendered":"<div class=\"hint\">\nThe CSF (Slurm) cluster is now available using the address:<\/p>\n<p><code>csf3.itservices.manchester.ac.uk<\/code>\n<\/div>\n<p>All logins to the CSF3 must be done with an <em>SSH<\/em> (secure shell) app. Linux and OS-X users will be able use the <code>ssh<\/code> command, which comes with all popular distributions of Linux and OS-X, run from a <em>Terminal<\/em> program:<\/p>\n<ul>\n<li>On a Mac: <em>Go &gt; Utilities &gt; Terminal<\/em><\/li>\n<li>On Linux (gnome): <em>Applications &gt; System Tools &gt; Terminal<\/em><\/li>\n<\/ul>\n<p>From the terminal program, to connect to the CSF, for example:<\/p>\n<pre>\r\n# Note: You will NOT be able to open GUI-apps on the CSF (e.g. gedit) when using this command\r\nssh <em>username<\/em>@csf3.itservices.manchester.ac.uk\r\n\r\n# To use GUI apps on the CSF (e.g. gedit), use this command on Linux and Mac:\r\n# NOTE: Mac users will <em>first<\/em> need to install XQuartz and reboot their mac (see below):\r\nssh -X <em>username<\/em>@csf3.itservices.manchester.ac.uk\r\n     #\r\n     # UPPERcase X\r\n\r\n# In newer macOS use -Y instead of -X\r\nssh -Y <em>username<\/em>@csf3.itservices.manchester.ac.uk\r\n     #\r\n     # UPPERcase Y\r\n<\/pre>\n<p>Replace <code><em>username<\/em><\/code> with your central University username. Your password is your central IT Services password. You may then be presented with a 2FA stage.<\/p>\n<h4><b>Off-campus<\/b><\/h4>\n<p>If logging in from off-campus you will first need to be connected to the <a href=\"http:\/\/www.itservices.manchester.ac.uk\/vpn\">University VPN (GlobalProtect)<\/a> &#8211; You may already connect to the University VPN in order to access your email.<\/p>\n<ul>\n<li>University <em>managed<\/em> laptops already have the GlobalProtect software installed. You can also download it and run it on your home PC\/laptop.<\/li>\n<li>If not already installed, please install the <a href=\"http:\/\/www.itservices.manchester.ac.uk\/ourservices\/popular\/vpn\/\">IT Services VPN Software (GlobalProtect)<\/a> on your home PC\/laptop.<\/li>\n<li>This facility is provided by IT Services (not Research IT). Requests for help with the VPN and\/or GlobalProtect should be made to <a href=\"http:\/\/www.itservices.manchester.ac.uk\/help\/\">via the Support Portal<\/a>.<\/li>\n<\/ul>\n<h4><b>On-campus<\/b><\/h4>\n<p>If on-campus you will need to authenticate using your 2FA device.<\/p>\n<p>If you use the Duo mobile app as your 2FA device, Enter &#8216;1&#8217; at the prompt and press Enter. Once the push notification has been received via the Duo mobile app &#8216;Approve&#8217; the request in order to log on.<\/p>\n<pre>$ ssh <em>username<\/em>@csf3.itservices.manchester.ac.uk\r\nPassword:\r\nEnter a passcode or select one of the following options: \r\n\r\n1. Duo Push to +XX XXXX XXX555\r\n\r\nPasscode or option (1-1):1\r\n<\/pre>\n<p><strong>OR<\/strong><\/p>\n<p>If you use a Duo fob as your 2FA device, generate a passcode with the fob, type the passcode at the prompt and press Enter<\/p>\n<pre>$ ssh <em>username<\/em>@csf3.itservices.manchester.ac.uk\r\nPassword:\r\nDuo two-factor login for <em>username<\/em>\r\n\r\nPasscode: 123456\r\n<\/pre>\n<h2>To run GUI apps on the CSF<\/h2>\n<p>You need functionality known as X windows. This is available on Linux by default.<\/p>\n<p>On a MAC you need to install <a href=\"https:\/\/www.xquartz.org\/\">Xquartz<\/a>.<\/p>\n<p>Then to run a GUI application on the CSF please add <code>-Y<\/code> to your command line. e.g.<\/p>\n<pre>\r\n$ ssh -Y <em>username<\/em>@csf3.itservices.manchester.ac.uk\r\n\r\n# In older macOS use -X\r\n$ ssh -X <em>username<\/em>@csf3.itservices.manchester.ac.uk\r\n<\/pre>\n<h2>Troubleshooting common errors encountered while trying to run GUI apps on the CSF using XQuartz on macOS<\/h2>\n<h3>1. Gtk-WARNING **: Cannot open display: Connection refused<\/h3>\n<p>You might come across the following error while trying to run GUI apps (e.g. gedit) after some macOS updates:<\/p>\n<p><a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-content\/uploads\/TheError.png\" target=\"_blank\"><img decoding=\"async\" src=\"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-content\/uploads\/TheError.png\" alt=\"Error Message\" width=\"500\" style=\"padding:1px;border:medium solid #6B2C91;\" \/><\/a><\/p>\n<p>This is caused by the macOS update which changes some settings in <strong><em>System Preferences<\/em><\/strong> of macOS. Shown below are the steps to rectify the changes:<\/p>\n<p>First check if XQuartz starts and stays on without crashing after the update. If It says &#8216;XQuartz crashed unexpectedly&#8217; then you will need to uninstall it and install it afresh.<\/p>\n<p>Next open <strong><em>System Preferences<\/em><\/strong> then navigate to <strong><em>General (1)<\/em><\/strong>  &#62; <strong><em>Login Items &#038; Extensions (2)<\/em><\/strong><\/p>\n<p><a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-content\/uploads\/Set1.png\" target=\"_blank\"><img decoding=\"async\" src=\"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-content\/uploads\/Set1.png\" alt=\"\" width=\"500\" style=\"padding:1px;border:medium solid #6B2C91;\" \/><\/a><\/p>\n<p>Inside <strong><em>Login Items &#038; Extensions<\/em><\/strong> menu, check if <strong><em>LaunchAgents<\/em><\/strong> folder is present under <strong><em>Open at login<\/em><\/strong> as shown below (1),<br \/>\nif not click <strong><code> + <\/code><\/strong>(2) and then navigate and select the folder <strong><code>\/Library\/LaunchAgents<\/code><\/strong> to add it.<\/p>\n<p><a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-content\/uploads\/Set22.png\" target=\"_blank\"><img decoding=\"async\" src=\"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-content\/uploads\/Set22.png\" alt=\"\" width=\"500\" style=\"padding:1px;border:medium solid #6B2C91;\" \/><\/a><\/p>\n<p>Next, inside the same <strong><em>Login Items &#038; Extensions<\/em><\/strong> menu, scroll down to the very bottom and check if <strong><em>XQuartz<\/em><\/strong> is enabled as shown below, if not enable it.<\/p>\n<p><a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-content\/uploads\/Set3.png\" target=\"_blank\"><img decoding=\"async\" src=\"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-content\/uploads\/Set3.png\" alt=\"\" width=\"500\" style=\"padding:1px;border:medium solid #6B2C91;\" \/><\/a><\/p>\n<p>Finally close everything, log out of macOS and then re-login. Next, start XQuartz and then try logging in to CSF3 using macOS terminal and start a GUI app (e.g. gedit\/xterm). It should work and not throw the above error.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The CSF (Slurm) cluster is now available using the address: csf3.itservices.manchester.ac.uk All logins to the CSF3 must be done with an SSH (secure shell) app. Linux and OS-X users will be able use the ssh command, which comes with all popular distributions of Linux and OS-X, run from a Terminal program: On a Mac: Go &gt; Utilities &gt; Terminal On Linux (gnome): Applications &gt; System Tools &gt; Terminal From the terminal program, to connect to.. <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/getting-started\/connecting\/linux-mac\/\">Read more &raquo;<\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"parent":1271,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-1436","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/1436","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/comments?post=1436"}],"version-history":[{"count":23,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/1436\/revisions"}],"predecessor-version":[{"id":12411,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/1436\/revisions\/12411"}],"up":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/1271"}],"wp:attachment":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/media?parent=1436"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}