Network for Advanced NMR - User contributions [en]

Account Update

2026-09-14T16:55:04Z

Gweatherby: link FileZilla

Starting '''9/22/2026,''' NMRhub users will be required to use [[wikipedia:Multi-factor_authentication|Two factor authentication (2FA)]] to log into NMRhub services including NMRhub, NMRbox and NAN websites, connections to NMRbox servers via SSH or RealVNC, as well as [[FileZilla]] file copies to and from NMRbox servers. In addition, as part of the 2FA implementation, NMRhub accounts will be migrated to a new user account management system which requires a one-time password reset for all NMRhub accounts. All NMRhub users should follow the process below to complete the initial setup steps include resetting password, setting password recovery questions and adding NMRhub in an authenticator application.

== Step 1: Begin to log into NMRhub to Generate the Magic Link ==
Begin the log-in process on NMRhub with your current NMRhub account. An email from support@nmrhub.org that contains a magic link will be sent to the email address associated with your NMRhub account to start the 2FA set up process.

[[File:Email check.png|frameless|600x600px]]

The email is as below:<blockquote>''Dear <user>,''

''We received a request to reset your password for NMRhub username: <username>''

''Please click here and follow the prompts to update your password.''

''If you did not request a password reset, please contact us at: support@nmrhub.org''

''Thank you,''

''NMRhub Support Team''

''UConn Health''</blockquote>

== Step 2: Reset Password and Create Security Questions ==
Click on the link in the email. You will be guided through the following steps to complete the 2FA setup:

# Reset password. This step will be skipped if you've recently reset your password. The new password must meet the current password complexity rules.
# Create security questions and the answers to them:

=== Security questions ===
After setting your password (if required), complete security questions:

[[File:Questions.png|frameless|600x600px]]

== Step 3: Add NMRhub account to your authenticator application ==
Scan the QR code and add NMRhub to the authenticator app of your choosing.

[[File:Qrcode.png|frameless|600x600px]]

== Step 4: Log in ==
After you finish setting up the 2FA authenticator, log into NMRhub - You will be required to enter a One-Time-Password (OTP) generated in your phone authenticator app.

While you may save your password in a password manager, the OTP will be generated in real time and need to be entered after the previous 2FA authentication expires.

[[File:Keycloak.png|frameless|600x600px]]

Draft::FileZilla

2026-09-14T16:54:00Z

Gweatherby: Gweatherby moved page Draft::FileZilla to FileZilla: completed

#REDIRECT [[FileZilla]]

FileZilla

2026-09-14T16:54:00Z

Gweatherby: Gweatherby moved page Draft::FileZilla to FileZilla: completed

[https://filezilla-project.org FileZilla] supports connecting via SSH key and One Time Password (OTP).

== Generate SSH Key Pair ==
You will need to generate a SSH key pair (private key and public key) on your computer. The private key will be stored on your computer and the public key is stored in your home folder. The [https://nmrbox.nmrhub.org/user-dashboard/ssh-key Manage SSH keys page] provide instructions on generating keys and uploading your public key.

=== Windows ===

To set the key, go to ''Edit'' -> ''Settings'' and select '''SFTP'''. Click ''Add key file...'' and add your private ssh key.

[[File:Winfzsftp.png|alt=SFTP dialog with Add key file...|frameless|600x600px]]
=== Mac OS X ===

To set the key, go to ''FileZilla'' -> ''Settings'' and select '''SFTP'''. Click ''Add key file...'' and add your private ssh key.

[[File:Fzmac.png|frameless|600x600px]]

== Set site to Interactive Logon ==
Go to ''File'' -> ''Site Manager'' and add new site.

Use '''SFTP''' for protocol, the name of the host you want to use, Logon Type: Interactive, and add your NMRhub username. Press '''OK''' to save settings.

[[File:Winfzinteractive edited.png|frameless|600x600px]]

== Connect with OTP ==
When ready to connect, open Site Manager again and press '''Connect.'''

Enter the current OTP generated in your Authenticator app in real time.

[[File:Winfzotp edited.png|frameless|600x600px]]

Draft::Account Update

2026-09-14T16:53:15Z

Gweatherby: Gweatherby moved page Draft::Account Update to Account Update: No longer draft

#REDIRECT [[Account Update]]

Account Update

2026-09-14T16:53:15Z

Gweatherby: Gweatherby moved page Draft::Account Update to Account Update: No longer draft

Starting '''9/22/2026,''' NMRhub users will be required to use [[wikipedia:Multi-factor_authentication|Two factor authentication (2FA)]] to log into NMRhub services including NMRhub, NMRbox and NAN websites, connections to NMRbox servers via SSH or RealVNC, as well as FileZilla file copies to and from NMRbox servers. In addition, as part of the 2FA implementation, NMRhub accounts will be migrated to a new user account management system which requires a one-time password reset for all NMRhub accounts. All NMRhub users should follow the process below to complete the initial setup steps include resetting password, setting password recovery questions and adding NMRhub in an authenticator application.

== Step 1: Begin to log into NMRhub to Generate the Magic Link ==
Begin the log-in process on NMRhub with your current NMRhub account. An email from support@nmrhub.org that contains a magic link will be sent to the email address associated with your NMRhub account to start the 2FA set up process.

[[File:Email check.png|frameless|600x600px]]

The email is as below:<blockquote>''Dear <user>,''

''We received a request to reset your password for NMRhub username: <username>''

''Please click here and follow the prompts to update your password.''

''If you did not request a password reset, please contact us at: support@nmrhub.org''

''Thank you,''

''NMRhub Support Team''

''UConn Health''</blockquote>

== Step 2: Reset Password and Create Security Questions ==
Click on the link in the email. You will be guided through the following steps to complete the 2FA setup:

# Reset password. This step will be skipped if you've recently reset your password. The new password must meet the current password complexity rules.
# Create security questions and the answers to them:

=== Security questions ===
After setting your password (if required), complete security questions:

[[File:Questions.png|frameless|600x600px]]

== Step 3: Add NMRhub account to your authenticator application ==
Scan the QR code and add NMRhub to the authenticator app of your choosing.

[[File:Qrcode.png|frameless|600x600px]]

== Step 4: Log in ==
After you finish setting up the 2FA authenticator, log into NMRhub - You will be required to enter a One-Time-Password (OTP) generated in your phone authenticator app.

While you may save your password in a password manager, the OTP will be generated in real time and need to be entered after the previous 2FA authentication expires.

[[File:Keycloak.png|frameless|600x600px]]

Account Update

2026-09-14T15:23:32Z

Gweatherby: verb tense

Starting '''9/22/2026,''' NMRhub users will be required to use [[wikipedia:Multi-factor_authentication|Two factor authentication (2FA)]] to log into NMRhub services including NMRhub, NMRbox and NAN websites, connections to NMRbox servers via SSH or RealVNC, as well as FileZilla file copies to and from NMRbox servers. In addition, as part of the 2FA implementation, NMRhub accounts will be migrated to a new user account management system which requires a one-time password reset for all NMRhub accounts. All NMRhub users should follow the process below to complete the initial setup steps include resetting password, setting password recovery questions and adding NMRhub in an authenticator application.

== Step 1: Log into NMRhub to Generate the Magic Link ==
Log into NMRhub with your current NMRhub account and password. An email from support@nmrhub.org that contains a magic link will be sent to the email address associated with your NMRhub account to start the 2FA set up process.

[[File:Email check.png|frameless|600x600px]]

The email is as below:<blockquote>''Dear <user>,''

''We received a request to reset your password for NMRhub username: <username>''

''Please click here and follow the prompts to update your password.''

''If you did not request a password reset, please contact us at: support@nmrhub.org''

''Thank you,''

''NMRhub Support Team''

''UConn Health''</blockquote>

== Step 2: Reset Password and Create Security Questions ==
Click on the link in the email. You will be guided through the following steps to complete the 2FA setup:

# Reset password. This step will be skipped if you've recently reset your password. The new password must meet the current password complexity rules.
# Create security questions and the answers to them:

=== Security questions ===
After setting your password (if required), complete security questions:

[[File:Questions.png|frameless|600x600px]]

== Step 3: Add NMRhub account to your authenticator application ==
Scan the QR code and add NMRhub to the authenticator app of your choosing.

[[File:Qrcode.png|frameless|600x600px]]

== Step 4: Log in ==
After you finish setting up the 2FA authenticator, log into NMRhub - You will be required to enter a One-Time-Password (OTP) generated in your phone authenticator app.

While you may save your password in a password manager, the OTP will be generated in real time and need to be entered after the previous 2FA authentication expires.

[[File:Keycloak.png|frameless|600x600px]]

FileZilla

2026-09-14T15:19:47Z

Gweatherby: /* Generate SSH Key Pair */ link to upload page. Home page on all servers is the same.

Account Update

2026-09-08T16:37:57Z

Gweatherby: /* Update process */ italicize email, typos

On '''TBD,''' NMRhub will switch over to requiring [https://en.wikipedia.org/wiki/Multi-factor_authentication Two factor authentication]. This will require setting up an authenticator and setting recovery questions.

== Update process ==
When logging in to website after update, you will receive a notification to check your institution email

[[File:Email check.png|frameless|600x600px]]

Look for email similar to<blockquote>''Hello <user>,''

''NMRbox is moving to a new account system, and your account needs a few minutes of your''

''attention before you can sign in again. Nothing has gone wrong, and you have not been''

''locked out -- but this has to be done before the changeover, or you will lose access to''

''NMRbox, including SSH and VNC.''

''Use this link to finish setting up your account:''

''<nowiki>https://nmrhub.org/forgot-password/</nowiki><long string>''

''It will walk you through whatever is still outstanding: setting a password, choosing two''

''security questions, and setting up an authenticator app for two-factor sign-in. Have your''

''phone to hand -- you will need to install an authenticator app if you do not already have''

''one. The link is good for 24 hours; if it expires, just start signing in again and we''

''will send you a fresh one.''

''If you have any trouble, reply to this message or write to''

''support@nmrbox.org and we will help you through it.''

''— The NMRbox team''</blockquote>

== Security questions ==
Following the link, complete security questions:

[[File:Questions.png|frameless|600x600px]]

== OTP QR code ==
You will then be prompted to add a QR (quick-response) code to your authenticator app and verify the code it returns.

[[File:Qrcode.png|frameless|600x600px]]

== Logging in ==
Finally, you'll be taken to the logon page for the website and Opensearch Dashboards.

While you can save your password in a password manager, the OTP will change and will need to entered.

[[File:Keycloak.png|frameless|600x600px]]

As long as you are using the same browser on the same machine, website logon will only be needed periodically.

Account Update

2026-09-02T20:01:17Z

Gweatherby: 600px

On '''TBD,''' NMRhub will switch over to requiring [https://en.wikipedia.org/wiki/Multi-factor_authentication Two factor authentication]. This will require setting up an authenticator and setting recovery questions.

== Update process ==
When logging in to website after update, you will receive a notification to check your institution email

[[File:Email check.png|frameless|600x600px]]

Look for email similar to<blockquote>Hello <user>,

NMRbox is moving to a new account system, and your account needs a few minutes of your

attention before you can sign in again. Nothing has gone wrong, and you have not been

locked out -- but this has to be done before the changeover, or you will lose access to

NMRbox, including SSH and VNC.

Use this link to finish setting up your account:

<nowiki>https://nmrhub.org/forgot-password/<long string> </nowiki>

It will walk you through whatever is still outstanding: setting a password, choosing two

security questions, and setting up an authenticator app for two-factor sign-in. Have your

phone to hand -- you will need to install an authenticator app if you do not already have

one. The link is good for 24 hours; if it expires, just start signing in again and we

will send you a fresh one.

If you have any trouble, reply to this message or write to

support@nmrbox.org and we will help you through it.

— The NMRbox team</blockquote>

== Security questions ==
Following the link, complete security questions:

[[File:Questions.png|frameless|600x600px]]

== OTP QR code ==
You will then be prompted to add a QR (quick-response) code to your authenticator app and verify the code it returns.

[[File:Qrcode.png|frameless|600x600px]]

== Logging in ==
Finally, you'll be taken to the logon page for the website and Opensearch Dashboards.

While you make save your password in a password manager, the OTP will change and need to entered.

[[File:Keycloak.png|frameless|600x600px]]

As long as you are using the same browser on the same machine, website logon will only be need periodically.

Account Update

2026-09-02T19:57:53Z

Gweatherby: qr code, keycloak

On '''TBD,''' NMRhub will switch over to requiring [https://en.wikipedia.org/wiki/Multi-factor_authentication Two factor authentication]. This will require setting up an authenticator and setting recovery questions.

== Update process ==
When logging in to website after update, you will receive a notification to check your institution email

[[File:Email check.png|frameless]]

Look for email similar to<blockquote>Hello <user>,

NMRbox is moving to a new account system, and your account needs a few minutes of your

attention before you can sign in again. Nothing has gone wrong, and you have not been

locked out -- but this has to be done before the changeover, or you will lose access to

NMRbox, including SSH and VNC.

Use this link to finish setting up your account:

<nowiki>https://nmrhub.org/forgot-password/<long string> </nowiki>

It will walk you through whatever is still outstanding: setting a password, choosing two

security questions, and setting up an authenticator app for two-factor sign-in. Have your

phone to hand -- you will need to install an authenticator app if you do not already have

one. The link is good for 24 hours; if it expires, just start signing in again and we

will send you a fresh one.

If you have any trouble, reply to this message or write to

support@nmrbox.org and we will help you through it.

— The NMRbox team</blockquote>

== Security questions ==
Following the link, complete security questions:

[[File:Questions.png|frameless]]

== OTP QR code ==
You will then be prompted to add a QR (quick-response) code to your authenticator app and verify the code it returns.

[[File:Qrcode.png|frameless]]

== Logging in ==
Finally, you'll be taken to the logon page for the website and Opensearch Dashboards.

While you make save your password in a password manager, the OTP will change and need to entered.

[[File:Keycloak.png|frameless]]

As long as you are using the same browser on the same machine, website logon will only be need periodically.

File:Keycloak.png

2026-09-02T19:50:30Z

Gweatherby: sample keycloak login page

== Summary ==
sample keycloak login page

File:Qrcode.png

2026-09-02T19:48:44Z

Gweatherby: same QRCode URI with a dummy base32 secret (JBSWY3DPEHPK3PXP) — it's the same secret used in the RFC/Google Authenticator sample code

== Summary ==
same QRCode
URI with a dummy base32 secret (JBSWY3DPEHPK3PXP) — it's the same secret used in the RFC/Google Authenticator sample code

Account Update

2026-09-02T19:41:56Z

Gweatherby: security questions

On '''TBD,''' NMRhub will switch over to requiring [https://en.wikipedia.org/wiki/Multi-factor_authentication Two factor authentication]. This will require setting up an authenticator and setting recovery questions.

== Update process ==
When logging in to website after update, you will receive a notification to check your institution email

[[File:Email check.png|frameless]]

Look for email similar to<blockquote>Hello <user>,

NMRbox is moving to a new account system, and your account needs a few minutes of your

attention before you can sign in again. Nothing has gone wrong, and you have not been

locked out -- but this has to be done before the changeover, or you will lose access to

NMRbox, including SSH and VNC.

Use this link to finish setting up your account:

<nowiki>https://nmrhub.org/forgot-password/<long string> </nowiki>

It will walk you through whatever is still outstanding: setting a password, choosing two

security questions, and setting up an authenticator app for two-factor sign-in. Have your

phone to hand -- you will need to install an authenticator app if you do not already have

one. The link is good for 24 hours; if it expires, just start signing in again and we

will send you a fresh one.

If you have any trouble, reply to this message or write to

support@nmrbox.org and we will help you through it.

— The NMRbox team</blockquote>

== Security questions ==
Following the link, complete security questions:

[[File:Questions.png|frameless]]

File:Questions.png

2026-09-02T19:26:28Z

Gweatherby: security questions

== Summary ==
security questions

Account Update

2026-09-02T19:22:09Z

Gweatherby: nowiki

Account Update

2026-09-02T19:20:58Z

Gweatherby: /* Update process */ plain

Account Update

2026-09-02T19:19:54Z

Gweatherby: email

File:Email check.png

2026-09-02T19:07:24Z

Gweatherby: Prompt to check email

== Summary ==
Prompt to check email

Account Update

2026-09-02T19:06:05Z

Gweatherby: create

FileZilla

2026-09-02T17:35:38Z

Gweatherby: images to 600px

[https://filezilla-project.org FileZilla] supports connecting via SSH key and One Time Password (OTP).

== Set private key ==
=== Windows ===

To set the key, go to ''Edit'' -> ''Settings'' and select '''SFTP'''. Click ''Add key file...'' and add your pair ssh key.

[[File:Winfzsftp.png|alt=SFTP dialog with Add key file...|frameless|600x600px]]
=== Mac OS X ===

To set the key, go to ''FileZilla'' -> ''Settings'' and select '''SFTP'''. Click ''Add key file...'' and add your pair ssh key.

[[File:Fzmac.png|frameless|600x600px]]
== Set site to Interactive Logon ==
Go to ''File'' -> ''Site Manager'' and add new site.

Use '''SFTP''' for protocol, the name of the host you want to used, Logon Type: Interactive, and add your NMRhub username. Press '''OK''' to save settings.

[[File:Winfzinteractive edited.png|frameless|600x600px]]

== Connect with OTP ==
When ready to connect, open Site Manager again and press '''Connect.'''

Enter the current time based OTP from your Authenticator app.

[[File:Winfzotp edited.png|frameless|600x600px]]

FileZilla

2026-09-02T17:34:03Z

Gweatherby: /* Connect with OTP */ image

[https://filezilla-project.org FileZilla] supports connecting via SSH key and One Time Password (OTP).

== Set private key ==
=== Windows ===

To set the key, go to ''Edit'' -> ''Settings'' and select '''SFTP'''. Click ''Add key file...'' and add your pair ssh key.

[[File:Winfzsftp.png|alt=SFTP dialog with Add key file...|frameless|400x400px]]
=== Mac OS X ===

To set the key, go to ''FileZilla'' -> ''Settings'' and select '''SFTP'''. Click ''Add key file...'' and add your pair ssh key.

[[File:Fzmac.png|frameless|400x400px]]
== Set site to Interactive Logon ==
Go to ''File'' -> ''Site Manager'' and add new site.

Use '''SFTP''' for protocol, the name of the host you want to used, Logon Type: Interactive, and add your NMRhub username. Press '''OK''' to save settings.

[[File:Winfzinteractive edited.png|frameless|400x400px]]

== Connect with OTP ==
When ready to connect, open Site Manager again and press '''Connect.'''

Enter the current time based OTP from your Authenticator app.

[[File:Winfzotp edited.png|frameless|400x400px]]

File:Winfzotp edited.png

2026-09-02T17:33:11Z

Gweatherby: Prompt for OTP

== Summary ==
Prompt for OTP

FileZilla

2026-09-02T17:32:20Z

Gweatherby: OTP

[https://filezilla-project.org FileZilla] supports connecting via SSH key and One Time Password (OTP).

== Set private key ==
=== Windows ===

To set the key, go to ''Edit'' -> ''Settings'' and select '''SFTP'''. Click ''Add key file...'' and add your pair ssh key.

[[File:Winfzsftp.png|alt=SFTP dialog with Add key file...|frameless|400x400px]]
=== Mac OS X ===

To set the key, go to ''FileZilla'' -> ''Settings'' and select '''SFTP'''. Click ''Add key file...'' and add your pair ssh key.

[[File:Fzmac.png|frameless|400x400px]]
== Set site to Interactive Logon ==
Go to ''File'' -> ''Site Manager'' and add new site.

Use '''SFTP''' for protocol, the name of the host you want to used, Logon Type: Interactive, and add your NMRhub username. Press '''OK''' to save settings.

[[File:Winfzinteractive edited.png|frameless|400x400px]]

== Connect with OTP ==
When ready to connect, open Site Manager again and press '''Connect.'''

Enter the current time based OTP from your Authenticator app.

FileZilla

2026-09-02T17:29:51Z

Gweatherby: /* Set Interactive site */ image

[https://filezilla-project.org FileZilla] supports connecting via SSH key and One Time Password (OTP).

== Set private key ==
=== Windows ===

To set the key, go to ''Edit'' -> ''Settings'' and select '''SFTP'''. Click ''Add key file...'' and add your pair ssh key.

[[File:Winfzsftp.png|alt=SFTP dialog with Add key file...|frameless|400x400px]]
=== Mac OS X ===

To set the key, go to ''FileZilla'' -> ''Settings'' and select '''SFTP'''. Click ''Add key file...'' and add your pair ssh key.

[[File:Fzmac.png|frameless|400x400px]]
== Set site to Interactive Logon ==
Go to ''File'' -> ''Site Manager'' and add new site.

Use '''SFTP''' for protocol, the name of the host you want to used, Logon Type: Interactive, and add your NMRhub username. Press '''OK''' to save settings.

[[File:Winfzinteractive edited.png|frameless|400x400px]]

File:Winfzinteractive edited.png

2026-09-02T17:28:06Z

Gweatherby: Site Manager on windows

== Summary ==
Site Manager on windows

FileZilla

2026-09-02T17:27:34Z

Gweatherby: interactive

[https://filezilla-project.org FileZilla] supports connecting via SSH key and One Time Password (OTP).

== Set private key ==
=== Windows ===

To set the key, go to ''Edit'' -> ''Settings'' and select '''SFTP'''. Click ''Add key file...'' and add your pair ssh key.

[[File:Winfzsftp.png|alt=SFTP dialog with Add key file...|frameless|400x400px]]
=== Mac OS X ===

To set the key, go to ''FileZilla'' -> ''Settings'' and select '''SFTP'''. Click ''Add key file...'' and add your pair ssh key.

[[File:Fzmac.png|frameless|400x400px]]
== Set Interactive site ==
Go to ''File'' -> ''Site Manager'' and add new site.

Use '''SFTP''' for protocol, the name of the host you want to used, Logon Type: Interactive, and add your NMRhub username. Press '''OK''' to save settings.

FileZilla

2026-09-02T17:18:30Z

Gweatherby: /* Mac OS X */ set pics

File:Fzmac.png

2026-09-02T17:15:07Z

Gweatherby: FileZilla settings on Mac

== Summary ==
FileZilla settings on Mac

FileZilla

2026-09-02T17:14:38Z

Gweatherby: win & mac

[https://filezilla-project.org FileZilla] supports connecting via SSH key and One Time Password (OTP).

== Set private key ==
=== Windows ===
[[File:Winfzsftp.png|alt=SFTP dialog with Add key file...|thumb|400x400px]]
To set the key, go to ''Edit'' -> ''Settings'' and select '''SFTP'''. Click ''Add key file...'' and add your pair ssh key.
=== Mac OS X ===
To set the key, go to ''FileZilla'' -> ''Settings'' and select '''SFTP'''. Click ''Add key file...'' and add your pair ssh key.

FileZilla

2026-09-02T17:10:42Z

Gweatherby: Windows SFTP setting

[https://filezilla-project.org FileZilla] supports connecting via SSH key and One Time Password (OTP).

=== Windows ===
[[File:Winfzsftp.png|alt=SFTP dialog with Add key file...|thumb|400x400px]]
To set the key, go to ''Edit'' -> ''Settings'' and select '''SFTP'''. Click ''Add key file...'' and add your pair ssh key.

File:Winfzsftp.png

2026-09-02T16:58:45Z

Gweatherby: Windows SFTP setting

== Summary ==
Windows SFTP setting

FileZilla

2026-09-02T16:57:34Z

Gweatherby: create

[https://filezilla-project.org FileZilla] supports connecting via SSH key and One Time Password (OTP).

Draft::authentication

2026-08-16T15:24:12Z

Gweatherby: create

= authentication update =
Effective TDB, the NMRhub projects will be switching authentication providers requiring two factor authorization. This is being done to improve security of user information and data.

== required actions ==

Why can't I create a New Request for UHF access?

2025-08-20T12:06:40Z

Gweatherby: typo in cat

{{FAQReturn}}

=== Why You May Not Be Able to Create a UHF Request ===

If you're unable to create a UHF request, consider the following possible reasons:

# '''You are not logged into the NAN web portal.'''
## Check the upper right-hand corner of the site in the NMRhub widget.
## The person icon should be green. If it is grey, you are not logged in.
## Log in before attempting to create a UHF request.

# '''You do not have permission to create a UHF request.'''
## Only PIs or users who have been granted '''UHF Submitter''' privileges can submit requests.
## A PI can assign this role via:
### '''Lab Administration → Permissions → Lab View'''

Please see [[UHF Access]] for requirements and instructions on creating UHF requests
[[Category:FAQ]] [[Category:UHF Access]]

SSH troubleshooting

2025-02-04T22:19:28Z

Gweatherby: Expand WinSCP section

== SSH Troubleshooting ==

[https://nmrhub.org NMRhub] now requires an SSH key pair to connect. Use [https://openssh.com SSH / SFTP / rsync] and tools like [https://filezilla-project.org FileZilla] to connect to NMRhub virtual machines (VMs).

=== Where is my private key? ===

After following the instructions at [https://nmrbox.nmrhub.org/user-dashboard/ssh-key NMRbox User Dashboard SSH Key Setup], your private key should be at:
* On Mac/Linux: <code>$HOME/.ssh/id_ed25519</code>
* On Windows: <code>%HOMEDRIVE%%HOMEPATH%\.ssh\id_ed25519</code>

=== I have the private key in place, but I can't connect. ===

# Try connecting to more than one VM to make sure it's not just an issue with that specific VM. (Please let us know if you can SSH to one VM but not another via [mailto:support@nmrbox.org support@nmrbox.org].)
# Use <code>ssh -vvv</code> to verify if SSH is attempting to use your private key.

==== It's trying to use the key, but it still doesn't work. ====

If you can't connect after uploading your SSH key, verify the following commands give the same result. Windows users should run these commands from PowerShell:

<syntaxhighlight lang="bash">
ssh-keygen -lf $HOME/.ssh/id_ed25519
ssh-keygen -lf $HOME/.ssh/id_ed25519.pub
</syntaxhighlight>

Ensure the key listed at [https://nmrbox.nmrhub.org/user-dashboard/ssh-key NMRbox User Dashboard SSH Key] matches your <code>$HOME/.ssh/id_ed25519.pub</code>.

[[File:sample.jpeg|thumb|Date key set]]

=== Home Directory Permissions ===

If your home directory is writable by anyone other than you, SSH will not work. Connect via [https://nmrbox.nmrhub.org/pages/getting-started VNC] and run:

<syntaxhighlight lang="bash">
ls -l ~
</syntaxhighlight>

If '''<code>w</code>''' appears after the first group of permissions (e.g., <code>drwx</code>), use the following command to correct it:

<syntaxhighlight lang="bash">
chmod go-w ~
</syntaxhighlight>

=== How do I use a private key with <code>rsync</code>? ===

Add the following option to your <code>rsync</code> command:

<syntaxhighlight lang="bash">
-e "ssh -i /path/to/your/private_key"
</syntaxhighlight>

=== How do I use a private key with <code>sftp</code>? ===

Add the following option to your <code>sftp</code> command:

<syntaxhighlight lang="bash">
-i /path/to/your/private_key
</syntaxhighlight>

=== How do I use a private key with FileZilla? ===

Go to FileZilla's '''Site Manager''' and make the following settings in the '''General''' tab. You can leave the port blank, as it defaults to the correct value (22).

* '''Protocol:''' SFTP - SSH File Transfer Protocol
* '''Host:''' ''element''.nmrbox.org
* '''Port:''' Leave blank
* '''Logon Type:''' Key file
* '''User:''' ''username''
* '''Key file:''' ''local path''/.ssh/id_ed25519

=== How do I use a private key with [https://winscp.net WinSCP]? ===

Note that NMRhub allows multiple keys to be uploaded to the dashboard. On Windows, [https://winscp.net/eng/docs/ui_puttygen PuTTYgen] can be used to generate an additional key. The PuTTYgen window provides the public key to add to the [https://nmrbox.nmrhub.org/user-dashboard/ssh-key NMRhub dashboard].

=== How do I <code>scp</code> from a shared account? ===

(Note: This is not an endorsement of shared accounts, but that is a site-specific decision.)

If multiple users are using a shared account (e.g., from a spectrometer console), the following steps will allow copying local data to each user's account. For this example, we assume your username is <code>rernst</code>.

# '''Create another SSH key pair with a passphrase:'''

<syntaxhighlight lang="bash">
ssh-keygen -t ed25519 -C "spectrometer scp"
Generating public/private ed25519 key pair.
Enter file in which to save the key (/Users/rernst/.ssh/id_ed25519): id_ed25519rernst
Enter passphrase (empty for no passphrase): <type a password>
Enter same passphrase again: <retype the password>
Your identification has been saved in id_ed25519rernst
Your public key has been saved in id_ed25519rernst.pub
</syntaxhighlight>

# '''Add''' the contents of <code>id_ed25519rernst.pub</code> to [https://nmrbox.nmrhub.org/user-dashboard/ssh-key NMRbox User Dashboard SSH Key].

# Go to the home directory of the shared account. Create an <code>.ssh</code> directory if necessary and ensure it has permissions <code>drwx------</code>:

<syntaxhighlight lang="bash">
cd $HOME
mkdir -p .ssh
chmod 700 .ssh
</syntaxhighlight>

# Create or edit <code>~/.ssh/config</code> and add the following lines:

<syntaxhighlight lang="bash">
Match User rernst Host *.nmrbox.org
IdentityFile ~/.ssh/id_ed25519rernst
</syntaxhighlight>

# You should now be able to copy data from the shared account to <code>nmrbox.org</code>:

<syntaxhighlight lang="bash">
scp fid rernst@*element*.nmrbox.org:
</syntaxhighlight>

When prompted:

<syntaxhighlight lang="text">
Enter passphrase for key 'home_directory/.ssh/id_ed25519rernst':
</syntaxhighlight>

Enter the password you used when creating the key pair.

SSH troubleshooting

2025-02-04T21:50:11Z

Gweatherby: Create from https://github.com/NMRhub/NMRhub_SSH_Troubleshooting/

== SSH Troubleshooting ==

[https://nmrhub.org NMRhub] now requires an SSH key pair to connect. Use [https://openssh.com SSH / SFTP / rsync] and tools like [https://filezilla-project.org FileZilla] to connect to NMRhub virtual machines (VMs).

=== Where is my private key? ===

After following the instructions at [https://nmrbox.nmrhub.org/user-dashboard/ssh-key NMRbox User Dashboard SSH Key Setup], your private key should be at:
* On Mac/Linux: <code>$HOME/.ssh/id_ed25519</code>
* On Windows: <code>%HOMEDRIVE%%HOMEPATH%\.ssh\id_ed25519</code>

=== I have the private key in place, but I can't connect. ===

# Try connecting to more than one VM to make sure it's not just an issue with that specific VM. (Please let us know if you can SSH to one VM but not another via [mailto:support@nmrbox.org support@nmrbox.org].)
# Use <code>ssh -vvv</code> to verify if SSH is attempting to use your private key.

==== It's trying to use the key, but it still doesn't work. ====

If you can't connect after uploading your SSH key, verify the following commands give the same result. Windows users should run these commands from PowerShell:

<syntaxhighlight lang="bash">
ssh-keygen -lf $HOME/.ssh/id_ed25519
ssh-keygen -lf $HOME/.ssh/id_ed25519.pub
</syntaxhighlight>

Ensure the key listed at [https://nmrbox.nmrhub.org/user-dashboard/ssh-key NMRbox User Dashboard SSH Key] matches your <code>$HOME/.ssh/id_ed25519.pub</code>.

[[File:sample.jpeg|thumb|Date key set]]

=== Home Directory Permissions ===

If your home directory is writable by anyone other than you, SSH will not work. Connect via [https://nmrbox.nmrhub.org/pages/getting-started VNC] and run:

<syntaxhighlight lang="bash">
ls -l ~
</syntaxhighlight>

If '''<code>w</code>''' appears after the first group of permissions (e.g., <code>drwx</code>), use the following command to correct it:

<syntaxhighlight lang="bash">
chmod go-w ~
</syntaxhighlight>

=== How do I use a private key with <code>rsync</code>? ===

Add the following option to your <code>rsync</code> command:

<syntaxhighlight lang="bash">
-e "ssh -i /path/to/your/private_key"
</syntaxhighlight>

=== How do I use a private key with <code>sftp</code>? ===

Add the following option to your <code>sftp</code> command:

<syntaxhighlight lang="bash">
-i /path/to/your/private_key
</syntaxhighlight>

=== How do I use a private key with FileZilla? ===

Go to FileZilla's '''Site Manager''' and make the following settings in the '''General''' tab. You can leave the port blank, as it defaults to the correct value (22).

* '''Protocol:''' SFTP - SSH File Transfer Protocol
* '''Host:''' ''element''.nmrbox.org
* '''Port:''' Leave blank
* '''Logon Type:''' Key file
* '''User:''' ''username''
* '''Key file:''' ''local path''/.ssh/id_ed25519

=== How do I use a private key with [https://winscp.net WinSCP]? ===

See [https://winscp.net/eng/docs/ui_login_authentication The Authentication Page].

=== How do I <code>scp</code> from a shared account? ===

(Note: This is not an endorsement of shared accounts, but that is a site-specific decision.)

If multiple users are using a shared account (e.g., from a spectrometer console), the following steps will allow copying local data to each user's account. For this example, we assume your username is <code>rernst</code>.

# '''Create another SSH key pair with a passphrase:'''

<syntaxhighlight lang="bash">
ssh-keygen -t ed25519 -C "spectrometer scp"
Generating public/private ed25519 key pair.
Enter file in which to save the key (/Users/rernst/.ssh/id_ed25519): id_ed25519rernst
Enter passphrase (empty for no passphrase): <type a password>
Enter same passphrase again: <retype the password>
Your identification has been saved in id_ed25519rernst
Your public key has been saved in id_ed25519rernst.pub
</syntaxhighlight>

# '''Add''' the contents of <code>id_ed25519rernst.pub</code> to [https://nmrbox.nmrhub.org/user-dashboard/ssh-key NMRbox User Dashboard SSH Key].

# Go to the home directory of the shared account. Create an <code>.ssh</code> directory if necessary and ensure it has permissions <code>drwx------</code>:

<syntaxhighlight lang="bash">
cd $HOME
mkdir -p .ssh
chmod 700 .ssh
</syntaxhighlight>

# Create or edit <code>~/.ssh/config</code> and add the following lines:

<syntaxhighlight lang="bash">
Match User rernst Host *.nmrbox.org
IdentityFile ~/.ssh/id_ed25519rernst
</syntaxhighlight>

# You should now be able to copy data from the shared account to <code>nmrbox.org</code>:

<syntaxhighlight lang="bash">
scp fid rernst@*element*.nmrbox.org:
</syntaxhighlight>

When prompted:

<syntaxhighlight lang="text">
Enter passphrase for key 'home_directory/.ssh/id_ed25519rernst':
</syntaxhighlight>

Enter the password you used when creating the key pair.

Main Page/Content building

2025-01-21T20:50:42Z

Gweatherby: Gweatherby moved page Main Page/Content building to Content building: Misspelled title

#REDIRECT [[Content building]]

Content building

2025-01-21T20:50:42Z

Gweatherby: Gweatherby moved page Main Page/Content building to Content building: Misspelled title

The NAN wiki content is available to the public.

Creating and editing pages is limited to users logged into [https://nmrhub.org NMRhub].

Information on categories is at [https://www.mediawiki.org/wiki/Help:Categories Help:Categories].

The *Help about MediaWiki* on the left sidebar link goes to the help page on formatting.

Content building

2025-01-21T20:50:01Z

Gweatherby: Starting tips

Main Page

2025-01-21T16:36:32Z

Gweatherby: /* Welcome to the Network for Advanced NMR (NAN) wiki */ -wiki

== Welcome to the Network for Advanced NMR (NAN) ==

Main Page

2025-01-21T14:41:03Z

Gweatherby: create

== Welcome to the Network for Advanced NMR (NAN) wiki ==