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.
Note: unlike mail command, msmtp requires some headers to be present in the body, this is explained is a section below (without that it is more likely to end up as spam).
Contents
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.
Using msmtp for debian gpg gateways
Debian's mail gateways that require gpg signed emails (for example debian-devel-announce) are known to reject mails sent with Thunderbird.
Evolution, mutt or msmtp would work.
If you want to use msmtp, you can create ~/.msmtprc with the following content,
account debian host mail-submit.debian.org port 587 tls on tls_starttls on auth on from <username>@debian.org user <username> # Set a default account account default : debian
Create the plain text content of the mail as mail.txt and sign it.
gpg --clearsign <mail.txt>
Add this pseudo header to the top of mail.txt.asc (adjust From and To addresses as required)
From: "Pirate Praveen" <username@debian.org> To: <listname@lists.debian.org> Subject: Testing msmtp with gpg for debian Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512
Now you can send this using msmtp.
msmtp -t < <mail.txt.asc>
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 |