documented the installation of SSH keys

git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk@3082 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

1 files changed, 49 insertions, 0 deletions

diff --git a/docutils/docs/dev/repository.txt b/docutils/docs/dev/repository.txt
index 208c1a45d..5311f9a1b 100644
--- a/docutils/docs/dev/repository.txt
+++ b/docutils/docs/dev/repository.txt
@@ -91,6 +91,55 @@ correct properties set::
     *.png = svn:mime-type=image/png
 
 
+Setting Up SSH Access
+`````````````````````
+
+With a public & private key pair, you can access the shell and
+Subversion servers without having to enter your password.  There are
+two places to add your SSH public key on BerliOS: your web account and
+your shell account.
+
+1. Adding your SSH key to your BerliOS web account:
+
+   * Log in on the web at https://developer.berlios.de/.  Create your
+     account first if necessary.  You should be taken to your "My
+     Personal Page" (https://developer.berlios.de/my/).
+
+   * Choose "Account Options" from the menu below the top banner.
+
+   * At the bottom of the "Account Maintenance" page
+     (https://developer.berlios.de/account/) you'll find a "Shell
+     Account Information" section; click on "[Edit Keys]".
+
+   * Copy and paste your SSH public key into the edit box on this page
+     (https://developer.berlios.de/account/editsshkeys.php).  Further
+     instructions are available on this page.
+
+2. Adding your SSH key to your BerliOS shell account:
+
+   * Log in to the BerliOS shell server::
+
+         ssh username@shell.berlios.de
+
+     You'll be asked for your password, which you set when you created
+     your account.
+
+   * Create a .ssh directory in your home directory, and remove
+     permissions for group & other::
+
+         mkdir .ssh
+         chmod og-rwx .ssh
+
+     Exit the SSH session.
+
+   * Copy your public key to the .ssh directory on BerliOS::
+
+         scp .ssh/id_dsa.pub username@shell.berlios.de:.ssh/authorized_keys
+
+   Now you should be able to start an SSH session without needing your
+   password.
+
+
 Web Access
 ----------