If you are having trouble getting started, don’t be discouraged! We acknowledge Artemis has a learning curve. However, we run regular training sessions to help help you learn to use Artemis.
The best way to get started with Artemis is to attend an Introduction to Unix training course, then attend an Introduction to Artemis HPC training course. Over two days, you will learn how to use the Linux command line and submit jobs to Artemis. No prior knowledge is necessary to attend the Introduction to Unix course, and the only assumed knowledge for the Introduction to Artemis course is what you learned in the Introduction to Unix course. Both courses are offered at no cost to University researchers.
The vast majority of Artemis users begin with little to no previous Linux/Unix computing background, so don’t be afraid to attend a training course because you believe you aren’t good enough with computers!
Contact firstname.lastname@example.org for more information on any training courses offered.
Linux Command Line Tutorials¶
If you prefer to learn how to use the Linux command line on your own rather than attend an Introduction to Unix training session, then we recommend working through Ryan’s Linux Tutorial. Once you finish the first five sections, you will have enough Linux command line knowledge to use Artemis. If you’re willing to invest time to work through the whole tutorial, you will learn tricks to work more efficiently in Linux command line environments.
Access to Artemis¶
Artemis access is available to all researchers at the University of Sydney with a valid UniKey. Get an Artemis account by create a project with Artemis HPC access in Researcher Dashboard (DashR). Alternatively, if you’re a member of a research group that already has Artemis access, ask your Lead Investigator to add you to one of their projects with Artemis access in DashR.
Artemis is accessible via SSH using your UniKey and password using the hostname hpc.sydney.edu.au. Throughout the guide, we use the example UniKey abcd1234. Remember to replace abcd1234 with your UniKey wherever needed.
For Windows-based access you can use an SSH client like PuTTY.
On Linux or MacOS you can use the SSH command in the built-in terminal app. Start the Terminal app, then type the following command to log in:
The recommended way of accessing Artemis from off-campus is by first connecting to the University VPN, then connecting to Artemis via SSH.
If you cannot use the VPN, you may instead connect via
(an intermediate host). First connect using an SSH client:
After logging in, connect to Artemis by typing the following into your session:
If you wish to connect from
jump.research.sydney.edu.au to Artemis without
typing a password, set up passwordless SSH using SSH key pairs. First, login
jump.research.sydney.edu.au and type:
and accept all defaults. Then type:
If successful, you will be able to log into Artemis from
without a password by typing:
For security reasons, SSH key pairs cannot be used between your computer and
You need to know your short project name, as specified in your Artemis HPC project in Researcher Dashboard (DashR). The names of your Artemis /project and /scratch directories and your Artemis jobs use this short project name.
There are two styles of project name you can use:
RDS-FAC-Project-RW(long project name)
Project(short project name)
Your long project name has the form
your faculty code and
Project is your short project name as
specified in your Artemis HPC project in DashR.
If you have access to Artemis, but don’t know
your project name, ask your Lead Investigator, or refer to your Artemis HPC project in
Throughout this guide, we will use the project
PANDORA in the examples
provided. Remember to replace
PANDORA with your short project name in
There are many pre-installed programs on Artemis, including various compilers, scripting languages (for example, Python, Perl and R), libraries and other specialised software. For full details, see the Software section. For a complete list of all installed software (updated monthly), see the Artemis Software List.
Opening GUI windows on Artemis¶
It is possible to open programs with a graphical user interface (GUI) on
Artemis if you have an X server running on your computer and ssh into
Artemis using either the
-Y options. Programs on Artemis with
GUIs include gedit (a text editor), Matlab and Gnuplot.
If you are on a Linux computer, such as Ubuntu or Linux Mint, then you
are already running an X server. Therefore, you can open programs with
GUIs if you log into Artemis using the
ssh -X email@example.com
On MacOS, you need to install XQuartz.
After installing XQuartz, you can then open a terminal window using
MacOS’s built-in terminal program, then SSH to Artemis using the
-Y options, as was the case for Linux.
On Windows, there are a number of X servers to choose from. The University of Sydney has a site license for Starnet X-Win32. Download and install X-Win32, then use the new connection wizard to set up an Artemis connection:
- Select SSH and give your connection a name. For example, “John’s Artemis connection”, then click next
- Enter the hostname:
- The login name and password are your UniKey credentials
- In the command to run on remote host, type
/usr/bin/xterm -ls -fa 'Consolas' -fs 11.
- Click Finish
Your new connection will appear in your connections list. To start a command line session on Artemis, click the connection you just made, then click Launch. A command line terminal connection to an Artemis login node will open. If everything was done correctly, you will be able to launch programs such as gedit from the command line.
It is possible to edit text files on Artemis using text editors such as
If you have logged into Artemis with an X server connection (that is,
-Y options to the ssh login command and a connection to
an X server running on your computer), then you can use gedit to edit
text files. If you don’t have an X server running, then the next
simplest text editor is
If you find yourself editing text files frequently on Artemis and want
to invest time to learn a more powerful text editor, then it is worth
Artemis Users mailing list¶
Important information about the Artemis HPC service is sent via the Artemis Users mailing list. When you obtain an Artemis account, you are automatically subscribed to this mailing list using your official University email address.
If you aren’t receiving emails from the Artemis users mailing list, it may be sent straight to your spam folder, or there may have been an issue subscribing you to the mailing list. If you believe you aren’t receiving emails from the mailing list, submit a High Performance Computing request via the ICT self-service portal. Select ICT Services -> Research -> High Performance Computing request after signing in and complete the form asking to be subscribed.
Information about the Artemis service is also posted on the Artemis HPC users Yammer group. Anyone with an @sydney.edu.au email address is welcome to follow and post to this group about anything of general interest to the Artemis HPC community. If you have specific support request, we recommend submitting a High Performance Computing request via the ICT self-service portal instead. Select ICT Services -> Research -> High Performance Computing request after signing in.