--- a/debian/README.Debian	Fri Sep 02 16:17:56 2011 +0200
+++ b/debian/README.Debian	Fri Sep 02 23:19:34 2011 +0200
@@ -1,6 +1,104 @@
 littlebird for Debian
 ---------------------
 
-<possible notes regarding this package - if none, delete this file>
+BEFORE INSTALLATION
+===================
+
+Just start with a normal Debian stable installation. (We tested the
+packages on a minimal installation, no X, no MC, just about the
+essential packages. Everything else will be pulled automatically.)
+If you want to see German dialogs during installation, you should
+activate the German language environment.
+
+Before installing the trustcenter packages, you need to add the
+following lines to your sources list or install the following snippet as
+"/etc/apt/sources.list.d/littlebird.list":
+
+::::8<-----
+// file: /etc/apt/sources.list.d/littlebird.list
+deb http://apt.net.schlittermann.de/debian-ius squeeze non-free
+deb http://repos.zend.com/zend-server/deb server non-free
+::::8<-----
+
+Then update the package information:
+
+    # aptitude update
+
+(Probably you did already if you're reading this file from an installed
+package ☺)
+
+* MySQL *
+
+The Trustcenter application needs access to some MySQL database. This
+database does not need to run on the same host (therefore our packages
+do not depend on the mysql-server). The trustcenter install process will
+ask you for the ADMIN user and ADMIN password to access the database
+server. We need this to install the database schema, create the
+trustcenter user, and define some functions.
+
+You need the AMIN user and ADMIN password to access the MySQL server.
+If you do not have any MySQL server, please install:
+
+    # aptitude install mysql-server
+
+PACKAGES
+========
+
+littlebird consists of the following packages:
+
+    littlebird-tc	    - virtual package to ease installation
+    littlebird-tc-common    - needed by all the other packages
+    littlebird-tc-core	    - the trustcenter web application
+    littlebird-tc-sql	    - sql scripts for database initialization
+
+
+Once you know the ADMIN credentials to access your MySQL server, you
+might:
+
+    # aptitude install littlebird-tc
+
+This will install all necessary packages, including the zend* packages.
+The littlebird-tc-sql is only pulled as recommended package, it depends
+on the configuration of your package manager, if it will be installed.
+
+If you need to preseed the database and the package is not installed
+already, you may want to
+
+    # aptitude install littlebird-tc-sql
+
+(But normally it gets installed automagically.)
+
+
+CONFIGURATION and RE-CONFIGURATION
+==================================
+
+We did our best to ask the proper questions. Please do your best to give
+the proper answers. If you want to reconfigure your littlebird
+trustcenter, you might run "dpkg-reconfigure":
+
+For initialization of the database:
+
+    # dpkg-reconfigure littlebird-tc-sql
+
+For database connection information (db name, db host, db user, …)
+    
+    # dpkg-reconfigure littlebird-tc-common
+
+For webserver setup (servername, serverport, SSL-Certificates, …)
+
+    # dpkg-reconfigure littlebird-tc-core
+
+INSTALLED and NOW?
+==================
+
+Take your browser and enter the servername you have choosen during
+package configuration. If you didn't provide the SSL certificate, the
+server will use a self signed cert, your browser will complain, it's up
+to you to accept it anyway.
+
+For further interaction with the trustcenter application you need a
+client certificate. Please ask Little Bird for this certificate and
+import it into your browser.
+
 
  -- Heiko Schlittermann <hs@schlittermann.de>  Tue, 30 Aug 2011 11:28:39 +0200