Hans-Nikolai Viessmann
bde174b726
refactor CSCS and Meg content add merlin6 quick start update merlin6 nomachine docs give the userdoc its own color scheme we use the Materials default one refactored slurm general docs merlin6 add merlin6 JB docs add software support m6 docs add all files to nav vibed changes #1 add missing pages further vibing #2 vibe #3 further fixes
61 lines
1.9 KiB
Markdown
61 lines
1.9 KiB
Markdown
---
|
|
title: Connecting from a MacOS Client
|
|
#tags:
|
|
keywords: MacOS, mac os, mac, connecting, client, configuration, SSH, X11
|
|
last_updated: 07 September 2022
|
|
summary: "This document describes a recommended setup for a MacOS client."
|
|
sidebar: merlin6_sidebar
|
|
permalink: /merlin6/connect-from-macos.html
|
|
---
|
|
|
|
## SSH without X11 Forwarding
|
|
|
|
This is the standard method. Official X11 support is provided through [NoMachine](nomachine.md).
|
|
For normal SSH sessions, use your SSH client as follows:
|
|
|
|
```bash
|
|
ssh $username@merlin-l-01.psi.ch
|
|
ssh $username@merlin-l-001.psi.ch
|
|
ssh $username@merlin-l-002.psi.ch
|
|
```
|
|
|
|
## SSH with X11 Forwarding
|
|
|
|
### Requirements
|
|
|
|
For running SSH with X11 Forwarding in MacOS, one needs to have a X server running in MacOS.
|
|
The official X Server for MacOS is **[XQuartz](https://www.xquartz.org/)**. Please ensure
|
|
you have it running before starting a SSH connection with X11 forwarding.
|
|
|
|
### SSH with X11 Forwarding in MacOS
|
|
|
|
Official X11 support is through NoMachine. Please follow the document
|
|
[{Job Submission -> Interactive Jobs}](../slurm-general-docs/interactive-jobs.md#requirements) and
|
|
[{Accessing Merlin -> NoMachine}](nomachine.md) for more details. However,
|
|
we provide a small recipe for enabling X11 Forwarding in MacOS.
|
|
|
|
* Ensure that **[XQuartz](https://www.xquartz.org/)** is installed and running in your MacOS.
|
|
|
|
* For enabling client X11 forwarding, add the following to the start of ``~/.ssh/config``
|
|
to implicitly add ``-X`` to all ssh connections:
|
|
|
|
```bash
|
|
ForwardAgent yes
|
|
ForwardX11Trusted yes
|
|
```
|
|
|
|
* Alternatively, you can add the option ``-Y`` to the ``ssh`` command. In example:
|
|
|
|
```bash
|
|
ssh -X $username@merlin-l-01.psi.ch
|
|
ssh -X $username@merlin-l-001.psi.ch
|
|
ssh -X $username@merlin-l-002.psi.ch
|
|
```
|
|
|
|
* For testing that X11 forwarding works, just run ``xclock``. A X11 based clock should
|
|
popup in your client session.
|
|
|
|
```bash
|
|
xclock
|
|
```
|