#pragma section-numbers off

This is the chapter of the MemberManual that describes how to log in to our machines, and provides a brief explanation of what our machines do.

<<TableOfContents>>

== Logging In ==

Only `ssh.hcoop.net` is accessible to members. To login, use [[http://www.openssh.org/|SSH]] where

 username :: Your HCoop username
 host :: `ssh.hcoop.net`
 host key fingerprint :: 46:8f:76:54:87:dc:52:7b:76:02:92:3b:a7:8a:2e:89
You may also use MitKerberos for [[/PasswordlessLogin]].

The current shell machine is [[ServerBog|bog]], and is running [[http://www.debian.org/releases/wheezy/|Debian GNU/Linux Wheezy]]. Further information about our servers is on the [[Hardware]] page.

=== GNU/Linux, OS X, BSD ===

Open a shell and run:

{{{
ssh USERNAME@ssh.hcoop.net
}}}

=== Microsoft Windows ===

If you use Windows and are unfamiliar with SSH, you will most likely want to install [[http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html|Putty]], a popular and FreeSoftware SSH client. See the [[http://the.earth.li/~sgtatham/putty/0.62/htmldoc/Chapter2.html#gs|putty getting started guide]] for more information.

== Security Restrictions ==

We have some security restrictions in place on the shell servers designed to thwart would-be attackers. Basic http, irc to trusted networks, etc. work by default, and we liberally grant requests for additional network permissions (See FirewallRules).

== Installing Software ==

Our shell server is running a basic installation of Debian Wheezy. You may find that all of the software you need is already installed, but if not you may [[https://members.hcoop.net/portal/apt|request installation of packages]] available in [[http://packages.debian.org/wheezy/|wheezy]] and [[http://packages.debian.org/wheezy-backports/|wheezy-backports]].

Software not provided by Debian may be manually installed somewhere like `~/local/` in your home directory.

== Tips ==

=== Changing Your Password ===

/* Not sure this belongs here, but this document seems like the place where a member might want to know how to change their password? */

On your first login, and thereafter on some regular basis (quarterly is generally alright), you should change your password. To do this, login to the shell server and run

{{{
kpasswd
}}}

It will prompt for your current password and your new password twice.

(We use `kpasswd` instead of the standard UNIX `passwd` because of an unfortunate interaction between MitKerberos and Debian's default PAM configuration).

=== Changing the Default Shell ===

If you wish to change your login shell, then create a symlink called
{{{~/.loginshell}}} whose target is your shell of choice.  Here is one
example:

{{{
ln -sf /bin/zsh ~/.loginshell
}}}

----
CategoryNeedsWork CategoryMemberManual