sphinx/index.rst

   1 ***********************************************
   2  Welcome to the Debian Neuroscience Repository
   3 ***********************************************
   4
   5 This repository provides mostly neuroscience-related packages to be
   6 used on Debian systems (or Debian-derivatives like Ubuntu). It
   7 contains both unofficial or prospective packages which are not
   8 available from the main Debian archive, as well backported or simply
   9 rebuilt packages also available elsewhere.
  10
  11 This service is provided "as is". There is no guarantee that a package
  12 works as expected, so use them at your own risk. They might kill your
  13 system (although that is rather unlikely). You've been warned!
  14
  15 The repository contains both neuroscience-related packages, as well as general
  16 purpose software which is necessary to resolve dependencies, or such that is
  17 simply useful in the neuroscience context. All featured neuroscience software
  18 packages are available from the :ref:`full package list <full_pkg_list>`.
  19
  20
  21 .. _repository_howto:
  22
  23 How to use this repository
  24 ==========================
  25
  26 The easiest way to use this repository is to download an APT-configuration file
  27 (`sources.list`). Simply choose your target distribution/release and download
  28 the configuration for a mirror close to you (depending on your browser, you
  29 might have to right-click and choose 'save as'). Once downloaded, put the file
  30 in the `/etc/apt/sources.list.d/` directory on your system. Moving files in
  31 this directory will require superuser privileges, therefore you should probably
  32 download the file into a temporary directory and subsequently move it into
  33 `/etc/apt/sources.list.d/`. APT-configurations are available for the following
  34 releases and repository mirrors:
  35
  36 .. include:: sources_lists
  37
  38 Once this is done, you have to update the package index. Use your favorite
  39 package manager, e.g. synaptic, adept, or whatever you like. In the terminal
  40 you can use :command:`aptitude` to achieve the same::
  41
  42   sudo aptitude update
  43
  44 Now, you can proceed to install packages, e.g.::
  45
  46   sudo aptitude install lipsia
  47
  48 .. note::
  49   Not every package is available for all distributions/releases. For information
  50   about which package version is available for which release and architecture,
  51   please have a look at the corresponding package pages.
  52
  53
  54 Package authentication
  55 ----------------------
  56
  57 When you start using this repository, you probably get warning messages
  58 like this::
  59
  60   The following signatures couldn't be verified because
  61   the public key is not available.`
  62
  63 Or you will be asked questions like this over and over::
  64
  65   WARNING: The following packages cannot be authenticated!
  66   ...
  67   Install these packages without verification [y/N]?
  68
  69 This is because your APT installation initially does not know the GPG
  70 key that is used to sign the release files of this repository. Making
  71 APT happy again is easy:
  72
  73 1. Get the key. Either download the `repository key from here
  74    <_static/apsy.gse.uni-magdeburg.de.asc>`_
  75    or fetch it from *subkeys.pgp.net* (2649A5A9).
  76
  77 2. Now feed the key into APT by invoking::
  78
  79      apt-key add #file#
  80
  81    Where `#file#` has to be replaced with the location of the key file you just
  82    downloaded. You need to have superuser-privileges to do this (either do it
  83    as root or use sudo).