3 ***********************************************
4 Welcome to the Debian Neuroscience Repository
5 ***********************************************
7 This repository provides mostly neuroscience-related packages to be used on
8 Debian systems (or Debian-derivatives like Ubuntu). It contains both unofficial
9 or prospective packages which are not (yet) available from the main Debian
10 archive, as well backported or simply rebuilt packages also available
11 elsewhere. Please see the :ref:`faq` for more information about the goals of
14 This service is provided "as is". There is no guarantee that a package
15 works as expected, so use them at your own risk. They might kill your
16 system (although that is rather unlikely). You've been warned!
18 The repository contains both neuroscience-related packages, as well as general
19 purpose software which is necessary to resolve dependencies, or such that is
20 simply useful in the neuroscience context. All featured neuroscience software
21 packages are available from the :ref:`full package list <full_pkg_list>`.
28 <script src="http://widgets.twimg.com/j/2/widget.js"></script>
39 background: '#898989',
43 background: '#ffffff',
57 }).render().setUser('NeuroDebian').start();
62 How to use this repository
63 ==========================
65 The easiest way to use this repository is to download an APT-configuration file
66 (`sources.list`). Simply choose your target distribution/release and download
67 the configuration for a mirror close to you (depending on your browser, you
68 might have to right-click and choose 'save as'). Once downloaded, put the file
69 in the `/etc/apt/sources.list.d/` directory on your system. Moving files in
70 this directory will require superuser privileges, therefore you should probably
71 download the file into a temporary directory and subsequently move it into
72 `/etc/apt/sources.list.d/`. APT-configurations are available for the following
73 releases and repository mirrors:
75 .. include:: sources_lists
78 Thanks to the `Department of Experimental Psychology at the University of
79 Magdeburg`_, and the `Department of Psychological and Brain Sciences at Dartmouth
80 College`_ for hosting a mirror.
82 If your are interested in mirroring the repository, please see the :ref:`faq`.
84 .. _Department of Experimental Psychology at the University of Magdeburg: http://apsy.gse.uni-magdeburg.de
85 .. _Department of Psychological and Brain Sciences at Dartmouth College: http://www.dartmouth.edu/~psych
87 Once this is done, you have to update the package index. Use your favorite
88 package manager, e.g. synaptic, adept, or whatever you like. In the terminal
89 you can use :command:`aptitude` to achieve the same::
93 Now, you can proceed to install packages, e.g.::
95 sudo aptitude install lipsia
98 Not every package is available for all distributions/releases. For information
99 about which package version is available for which release and architecture,
100 please have a look at the corresponding package pages.
103 Package authentication
104 ----------------------
106 When you start using this repository, you probably get warning messages
109 The following signatures couldn't be verified because
110 the public key is not available.`
112 Or you will be asked questions like this over and over::
114 WARNING: The following packages cannot be authenticated!
116 Install these packages without verification [y/N]?
118 This is because your APT installation initially does not know the GPG
119 key that is used to sign the release files of this repository. Making
120 APT happy again is easy:
122 1. Get the key. Either download the `repository key from here
123 <_static/neuro.debian.net.asc>`_
124 or fetch it from http://wwwkeys.pgp.net (2649A5A9).
126 2. Now feed the key into APT by invoking::
130 Where `#file#` has to be replaced with the location of the key file you just
131 downloaded. You need to have superuser-privileges to do this (either do it
132 as root or use sudo).
135 .. _chap_installation:
143 If your are not running Debian_ on a particular machine a :ref:`chap_vm` is
144 provided as a convenient testing and evaluation environment. After a
145 few simple steps to setup the virtual machine, you will be able to use
146 NeuroDebian_ as an integral part of your existing working
147 environment without any sacrifice.
153 Having been exposed to the wonders of NeuroDebian_ you are no longer
154 satisfied with your previous choice of operating system? We would
155 recommend installing Debian_ to replace or complement (dual-boot) your
156 existing OS. Please visit `"Getting Debian"
157 <http://www.debian.org/distrib/>`_ to obtain the images for your
158 hardware architecture and then simply add |repos|.
167 Our main goal is to provide neuroscience FOSS for Debian_. Thus the
168 whole project would not be possible without the work of over 3,000
169 Debian_ developers and contributors who are enthusiastically share
170 our goal. To add our share -- Debian_ packages of FOSS for
171 neuroscience research -- the `Experimental Psychology Debian packaging
172 project <http://alioth.debian.org/projects/pkg-exppsy>`_ was created
173 to formally join the forces of
175 * `Michael Hanke <http://mih.voxindeserto.de>`_
176 * `Yaroslav Halchenko <http://www.onerussian.com>`_
178 Some packages provided within the NeuroDebian repository were not packaged
179 by our team, but were provided by similar Debian teams. Therefore we
180 want to express particular gratitude to `Debian Med`_ and `Debian
181 Science`_ teams for making their efforts.
187 `Email us <team@neuro.debian.net>`_ if you have any suggestions or
188 simply |spread| if you liked it.
200 .. probably should be purged altogether
208 .. include:: links_names.rst
209 .. include:: substitutions.rst