Notations

What is KDE SVN?

To have write access to KDE SVN, you have to use the main SVN server of KDE. (Anonymous SVN uses mirrors of this server. SVN does not allow you to read from one server and write to another.)

To be able to use the main KDE SVN server, you need an account there. An account is made up of a username (normally your family name), a password and an email address. The username is for getting in, the password for authenticating and the email address for knowing who to contact if another developer wants to contact the account holder. (The username is sometimes known also as the login.)

Note: you can see the accounts in kde-common/accounts. That is the list of all accounts. Yes, the account list is public, for example on WebSVN.

To access the main KDE SVN, you have two possibilities, with different ways to encrypt transmitted data:

using HTTPS

using SSH

If you have never used ssh before, you might prefer HTTPS, it's a bit simpler to set up.

However it seems that currently svn-over-ssh is really much faster than svn-over-https, so that is a good reason for using ssh.

The password you will need to create depends on the above:

a normal password for accessing by HTTPS, or

a SSH public key for accessing by SSH

A KDE SVN account allows you to write to nearly anywhere in the KDE SVN. However, there are exceptions:

the KDE SVN internals

the admin directory

the www module (exceptions can be made for this.)

Who Can Apply For a KDE SVN Account?

Normally, any developer who has done some work on KDE can apply for a KDE SVN account.

Translators should get approval from their team leader so that they can organize how the work is being done in his/her team. Please mention the approval from the team leader when requesting the account.

Also please apply for an account only if you think that you will work on KDE for a somewhat longer time. If you know that you will only work for a couple of weeks and then never again, please consider not applying for a KDE SVN account but still, do continue to send patches.

The limitations are not there to exclude anyone - they are there to ensure that the maintenance of accounts remains reasonable.

Of course, to be clear: the KDE's sysadmins have the last word about whether or not to create a KDE SVN account for somebody.

Getting the Encoded Password

Now that you have your password, you need to encode it, not to have to send it in clear. (Note: this encryption is the same type of encryption used by many Linux distributions for their /etc/shadow file.)

If your password is 8 characters long, one way to do this would be using Perl:

perl -e 'print crypt("<your password>","\$1\$xyz\$")."\n";'

where <your password> has to be replaced with your password and xyz with 3 to 8 random characters of your choice. Leave the \$1\$ before it and the \$ after it.

(Hint: $ must be "escaped" with a backslash. For instance: If your password is "abc$123" you have to replace <your password> with "abc\$123". )

Note: do not worry to find your choice of <xyz> at the start of the encoded password, it is meant to be so.

Another solution is to create a dummy account on a Unix system where you have administrator access. You can use the built-in user management programs of your distribution and search for the account in your file /etc/shadow or you can use the following code:

In any case, the password is then the part between the first ':' and the second ':'. (Note: not a star! (*) That means that it is not the password!)

Save the encoded password so that you can use it later in the application.

Getting the SSH keys

This section assumes that you want access via SSH (not with HTTPS). Otherwise skip this section.

Please refer to a SSH documentation or book to see how to create a pair of SSH keys, the short version is ssh-keygen -t dsa
The '-t dsa' indicates that 'dsa' type keys should be created. Dsa keys are used in the version 2 of the SSH protocol, whereas rsa keys are used in version 1. See the ssh documentation for more. Accept the default filename and the default of no passphrase.

You need a SSH public key. Don't send us a GPG (OpenPGP) key, that is completely unrelated!

The password in the sense of this documentation is the public key that you are creating. The public key can usually be found at $HOME/.ssh/id_dsa.pub.

Do not send the private key at $HOME/.ssh/id_dsa, it has to remain a secret.

You should also set up ssh-agent so you do not have to type the password every time. There are several tutorials available explaining how to do this, for example this one.

Note: if you already have an ssh key, you can just use the extisting key instead of creating a new one.

Tip

If you want to use SVN with SSH with another user than the one who created the keys, you need to copy $HOME/.ssh/id_dsa.pub and $HOME/.ssh/id_dsa to the other user's $HOME/.ssh directory.
You should probably also backup those files.

Setting up SVN+SSH protocol

Once you created your key, you'll have to tell SSH that this one should be used for all connections to KDE sites. Add the following lines to the ~/.ssh/config file. Replace USERNAME with yours.

Host *.kde.org
User USERNAME
IdentityFile ~/.ssh/id_dsa

The linked IdentityFile must belong to the public key you send in when applying for the SVN account. But it is not the public key (*.pub).

Apply for an account

Now that you have a password, you need a username for your KDE SVN account. Normally your family name is used. Let us call it username for this example.

You can propose something else if you want. But be careful that one day, you could ask for a KDE email address and this would be the base for your address. For example: username@kde.org. (Note, however, that KDE email addresses are not granted so easily anymore, as too many people have ranted with a KDE address and other people thought that it was the official position of the KDE Team. In the meantime, KDE Mail was created for if you need a permanent address.)

So now you have a username and a password. Now the email address: you have to use your own (be it a normal address or a KDE Mail address). Of course, do not forget that this email address becomes public (at least by WebSVN) so you will unfortunately get spam.

Also note that this email address should be the same one that you use on bugs.kde.org. If you don't have one, please create it so that it can be given usual developer rights. Closing bug reports with keywords in commit comments only works if the email address of your Subversion and bugs.kde.org accounts match.

After filling out the form, you will receive an email with a link to click on. This is done to verify your email address. The application is not complete before you click on it.

Also note that the form will ask you who has encouraged you to apply. He or she will also get an email to verify your request.

The form also holds a field justification, here you can explain what you want to do with your future KDE SVN account, like for examples developing a certain application, making documentations, being team leader of a translation...

And Now?

After having sent the form and clicking the link in the email, you have to wait for the answer (typically within two or three days).

Once you have confirmation that your account has been created, you need to adapt your local copy to the new server. See the next tutorial for your first steps with your new account.

Please add your geographical location (what country are you in?) and other details at the Commit Digest data page so that the Commit Digest can accurately reflect who is working where.