Instructions.mdwn 2.66 KB
Newer Older
Alexander Wirt's avatar
Alexander Wirt committed
1 2
[[!toc  startlevel=2]]

Alexander Wirt's avatar
Alexander Wirt committed
3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
## About backports ##

Backports are recompiled packages from testing (mostly) and unstable (in a few
cases only, e.g. security updates) in a stable environment so that they will
run without new libraries (whenever it is possible) on a Debian stable
distribution

Backports cannot be tested as extensively as Debian stable, and backports
are provided on an as-is basis, with risk of incompatibilities with other
components in Debian stable. Use with care!

It is therefore recommended to select single backported packages that fit
your needs, and not use all available backports.


Alexander Wirt's avatar
Alexander Wirt committed
18 19
##Add backports to your sources.list 

Alexander Wirt's avatar
Alexander Wirt committed
20 21
1.  For jessie add this line
    <pre>deb http://ftp.debian.org/debian jessie-backports main</pre> to your **sources.list** 
22
    (or add a new file with the ".list" extension to /etc/apt/sources.list.d/)
Alexander Wirt's avatar
Alexander Wirt committed
23
    You can also find a list of other mirrors at
Alexander Wirt's avatar
Alexander Wirt committed
24
    <https://www.debian.org/mirror/list>
Alexander Wirt's avatar
Alexander Wirt committed
25

Alexander Wirt's avatar
Alexander Wirt committed
26 27
    For stretch add this line
    <pre>deb http://ftp.debian.org/debian stretch-backports main</pre> to your **sources.list** 
Alexander Wirt's avatar
Alexander Wirt committed
28 29 30 31
    (or add a new file with the ".list" extension to /etc/apt/sources.list.d/)
    You can also find a list of other mirrors at
    <https://www.debian.org/mirror/list>

Alexander Wirt's avatar
Alexander Wirt committed
32 33 34 35
2. Run **apt-get update**

##Install a package from backports

36
All backports are deactivated by default (i.e. the packages are pinned to 100 by using ButAutomaticUpgrades: yes in the Release files. If you want to install something from backports run:
Alexander Wirt's avatar
Alexander Wirt committed
37

Alexander Wirt's avatar
Alexander Wirt committed
38
    apt-get -t stretch-backports install "package"
Alexander Wirt's avatar
Alexander Wirt committed
39 40 41

of course you can use aptitude as well:

Alexander Wirt's avatar
Alexander Wirt committed
42
    aptitude -t stretch-backports install "package"
Alexander Wirt's avatar
Alexander Wirt committed
43 44

##sloppy distributions
Alexander Wirt's avatar
Alexander Wirt committed
45

Rhonda D'Vine's avatar
Rhonda D'Vine committed
46 47
To guarantee a clean upgrade path from a previously stable distribution to the
next stable it is not allowed to upload packages from the current testing to
Alexander Wirt's avatar
Alexander Wirt committed
48
that backport distribution. To allow some newer packages for those systems we
Alexander Wirt's avatar
Alexander Wirt committed
49
create so called sloppy distributions. For oldstable (jessie) packages from
Alexander Wirt's avatar
Alexander Wirt committed
50
the current testing (stretch) are allowed to be uploaded to
Alexander Wirt's avatar
Alexander Wirt committed
51
jessie-backports-sloppy.
52

Alexander Wirt's avatar
Alexander Wirt committed
53
You can use it exactly as the current backports distribution, just add another line to your **sources.list** and install 
54
new packages via
Alexander Wirt's avatar
Alexander Wirt committed
55
	apt-get -t jessie-backports-sloppy install <packages>
Alexander Wirt's avatar
Alexander Wirt committed
56
    or
Alexander Wirt's avatar
Alexander Wirt committed
57
    apt-get -t stretch-backports install <packages>
Alexander Wirt's avatar
Alexander Wirt committed
58

59
##Subscribe to the security announce mailing list
Alexander Wirt's avatar
Alexander Wirt committed
60

61
If you want to get announcements about security updates on backports.debian.org subscribe to the [debian-backports-announce mailing list](https://lists.debian.org/debian-backports-announce/). 
Alexander Wirt's avatar
Alexander Wirt committed
62 63 64

##Report Bugs

65
Please report bugs that you found in the packages to the [backports mailing list](https://lists.debian.org/debian-backports/) and **NOT** to the Debian BTS!