1 files changed, 41 insertions, 0 deletions
diff --git a/USE.md b/USE.md
new file mode 100644
index 0000000..e5774bd
--- /dev/null
+++ b/USE.md
@@ -0,0 +1,41 @@
+# Shell introduction
+
+As member of [[org Virtual Assembly]]
+you can get a shell account at [[!host shell.virtual-assembly.org]].
+
+You need to [[contact sysadmins]] to get your shell account created.
+Provide your full name, email, and cellphone number,
+which is shared with all users
+for use in case of problems with your account.
+You may also suggest a name for your account
+(only lower-case simple letters).
+
+
+## Remote access
+
+Your shell environment is accessed via Secure Shell (ssh)
+authenticated by one or more public keys that you provide.
+
+Ssh public keys are stored on your own computer.
+
+Existing public keys can often be shown like this:
+
+	cat ~/.ssh/id_*.pub
+
+You can create a new key with a command like this:
+
+	ssh-keygen -t ed25519
+
+On Windows systems above does not work,
+and you can instead try use the tool PuTTY.
+
+
+## Mosh
+
+Regular SSH access require a reliable and responsive internet access.
+
+Optionally you can use the SSH wrapper tool [Mosh][]
+which allows your shell sessions to survive disruptive connections.
+
+[Mosh]: <https://mosh.org/>
+  "Mobile Shell"