Amber masthead
Filler image AmberTools23 Amber22 Manuals Tutorials Force Fields Contacts History
Filler image

Useful links:

Amber Home
Download Amber
Amber Citations
GPU Support
Mailing Lists
For Educators
File Formats
Jupyter Notebooks and Python

AMBER Tutorial

Using Jupyter notebook remotely

By Hai Nguyen (BSD 2-clause)


Your data (may be TB) is in your remote cluster. You want to access and interactively play with your data in Jupyter notebook. You can use xwin to open your Jupyter notebook on remote host. However, this kind of connection is quite slow.

You can follow each step below to have fast connection via SSH port forwarding.

1. In remote cluster

(remote cluster is where you store your data)

- cd /to/your/working/folder
- amber.jupyter notebook --no-browser --port=8000

Note: Use can specify any available port number

You will see something similiar to below

$ amber.jupyter notebook --no-browser --port=8000
    [I 15:12:45.032 NotebookApp] Serving notebooks from local directory: /u1/haichit/tutorials
    [I 15:12:45.032 NotebookApp] 0 active kernels 
    [I 15:12:45.032 NotebookApp] The Jupyter Notebook is running at: http://localhost:8000/
    [I 15:12:45.032 NotebookApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).
    [I 15:15:51.028 NotebookApp] 302 GET / ( 1.66ms

2. In your local machine (Windows, Mac laptop, ...)

  • Open your terminal and type:

    ssh -N -f -L localhost:8000:localhost:8000 your_account@your_cluster_address

    Note: replace "your_account@your_cluster_address" to your real login account (e.g:

  • Now open web browser, type "localhost:8000"

  • click "New" to create a new notebook

  • Type the command in each cell and then hit Shift-Enter to run and to create new Cell.