DebianDeveloper/Setup

?/Discussion

This page is a collection of setup procedures for when you become a DebianDeveloper.

The snippets on this page assume that you have a local MTA set up. If you do not want to, you can alternatively use msmtp instead of mail to connect to the SMTP server directly.

Contents

Updating your info in LDAP
Setup shell accounts
@debian mail address
DDPO
Bugs
Salsa
Keysigning
Benefits

Updating your info in LDAP

You must first set a password through the mail gateway, using this snippet:

echo "Please change my Debian password" | gpg --clearsign | mail chpasswd@db.debian.org

A randomly-generated password will be sent to your inbox. Using that, head to https://db.debian.org/ and use that password to set a new, memorable password as well as update your information and your forwarding address. Note that many fields are optional, so you don't have to provide everything.

Alternatively, you can manipulate your information via mail instead of the web interface; see https://db.debian.org/doc-mail.html

Setup shell accounts

Debian offers Debian Developers accounts to access several machines through SSH. You can set your authorized keys through the mail gateway with this snippet:

gpg --clearsign < .ssh/id_rsa.pub | mail changes@db.debian.org

Or if you use ssh-agent:

ssh-add -L | gpg --clearsign | mail changes@db.debian.org

Multiple keys are supported but they must all be sent in the same mail.

Some machines have a firewall that restricts SSH connections to some subnets, but they can still be reached by hopping ssh.debian.org. Put this in your ~/.ssh/config:

Host *.debian.org !*.ssh.debian.org !ssh.debian.org
    ProxyJump ssh.debian.org
    # (or {na,eu}.ssh.debian.org)

@debian mail address

As a Debian Developer, you are provided with a <username>@debian.org address where you can both receive and send mail.

Note that you are also able to receive mail at <username>-<suffix>@debian.org, <username>@people.debian.org, and <username>-<suffix>@people.debian.org.

You should change the DEBEMAIL variable in your shell configuration to this @debian.org address, as well as anywhere else where you would like to replace your old address.

Receiving mail

As outlined before, you can set your forwarding address at db.debian.org.

You can setup your own .forward or .procmailrc file to do this; see https://db.debian.org/forward.html. You can also set up .forward-<suffix> files to handle mail received at addresses with different suffixes.

Sending mail

Debian hosts an SMTP server at mail-submit.debian.org that can be used to send DKIM-signed mail.

First, you must receive a separate password to use with the SMTP server. This is done through the mail gateway using this snippet:

echo "Please change my mail password" | gpg --clearsign | mail chpasswd@db.debian.org

Once you receive the password, you can configure your mail software with the following parameters:

Server: mail-submit.debian.org
Port: 587
Login: Debian username (not the email)
Password: What you received from the mail gateway
Encryption: STARTTLS

More information can be found at https://dsa.debian.org/user/mail-submit/

Alternatively, you can use bsmtp to send mail from your @debian.org address through another Debian machine that supports this.

DDPO

If you intend to use your new @debian.org address as your maintainer address in packages, you can have your existing packages appear on the DDPO page for your @debian.org address. To do this, send an email to ddpo@qa.debian.org and include a list of subscribe <source package> [<section>] commands for the packages you maintain.

Alternatively, you can just use your name (if you don't have any homonyms) as the input to the DDPO to get all packages with your name rather than by email.

Bugs

If you want to change your email wherever you are listed as the submitter or owner on a bug, you can use the following script to output commands that can be sent to control@bugs.debian.org.

#!/bin/sh

# USAGE:
# export MAIL=foo@debian.org
# ./bts-submitter email1@example.com ... | mail control@bugs.debian.org

set -e

for field in submitter owner
do
    for email in $@
    do
        echo "# unarchived bugs with $field $email"
        for bug in `bts select $field:$email archive:0`
        do
            echo $field $bug !
        done

        echo "# archived bugs with $field $email"
        for bug in `bts select $field:$email archive:1`
        do
            echo unarchive $bug
            echo $field $bug !
            echo archive $bug
        done
    done
done
echo thanks

Salsa

If you do not yet have an account at salsa.debian.org, you should create one now. See Salsa/Doc for more information.

Keysigning

Now that you are a Debian Developer, consider listing yourself at Keysigning/Offers so that other contributors who need signatures on their keys can leverage your new status.

Benefits

Being a Debian Developer affords you certain benefits when interacting with external organizations.

License
License	CC BY-SA 4

DebianDeveloperSetup