diff --git a/fig/ssh_connection.png b/fig/ssh_connection.png new file mode 100644 index 0000000..5a54537 Binary files /dev/null and b/fig/ssh_connection.png differ diff --git a/fig/ssh_connection.svg b/fig/ssh_connection.svg new file mode 100644 index 0000000..71e61d0 --- /dev/null +++ b/fig/ssh_connection.svg @@ -0,0 +1,1532 @@ + + + +astro.data.nlAmy's computerssh connection/ssh tunnelhttps://openverse.org/image/e065c4bb-f74b-40b2-8104-1ba93cc1b129?q=computer%20svghttps://commons.wikimedia.org/wiki/File:Unicorn_openmoji.svghttps://freesvg.org/heart-with-circuitshttps://commons.wikimedia.org/wiki/File:Gnome-stock_person_admin4.svgssh amy@astro.data.nlenter your password: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +image/svg+xmlOpenclipart2011-10-15T13:35:40User of a web servicehttps://openclipart.org/detail/163753/web-user-by-lytelytecomputernetworkuser diff --git a/setup.md b/setup.md index b8c5032..124e151 100644 --- a/setup.md +++ b/setup.md @@ -1,7 +1,27 @@ --- title: Setup --- -FIXME +This tutorial requires a "shell" or "terminal" program. Below are instructions for installing this program on different operating systems. For more information on how to use the terminal program, see [here](https://swcarpentry.github.io/shell-novice/). + +### Windows Installation and Access + +If you are using Windows 10 version 1809 or a more recent version of the Windows OS, then you have access to a Windows SSH program called OpenSSH. More information about OpenSSH can be found [here](https://learn.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse?tabs=gui). + +If you are using an older version of Windows, you will need to install [the Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install). WSL has the ssh programs you need by default, so once you've installed WSL you are ready for this tutorial. + +### Mac Installation and Access + +For macOS, this application is called Terminal. To open Terminal, you can either + +* Open 'Finder', select the 'Go' menu, then select 'Utilties'. In the 'Utilities' folder you should be able to find and open 'Terminal'. + +* Use the Mac 'Spotlight' computer search function. Search for 'Terminal' and press `RETURN`. + +More information about how to use the Terminal application in macOS can be found [here](https://swcarpentry.github.io/shell-novice/). + +### Linux Installation and Access + +For Linux, you can access the terminal from the application menu or the search bar. For most Debian and Ubuntu based systems, `CTRL + ALT + T` will also open the terminal application. {% include links.md %}