{"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-04-02T16:19:00","modified_gmt":"2026-04-02T15:19:00","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<\/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>-X<\/code> to your command line. e.g.<\/p>\n<pre>\r\n$ ssh -X <em>username<\/em>@csf3.itservices.manchester.ac.uk\r\n<\/pre>\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":20,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/1436\/revisions"}],"predecessor-version":[{"id":12234,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/1436\/revisions\/12234"}],"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}]}}