diff --git a/debian/README.Debian b/debian/README.Debian
new file mode 100644
index 0000000000..3adc26d1cb
--- /dev/null
+++ b/debian/README.Debian
@@ -0,0 +1,25 @@
+Debian specific changes in gitlab
+=================================
+
+1. Redis connection: redis-server package in debian follows upstream default
+and listens on tcp port 6379. So gitlab package in debian is configured to use
+tcp sockets. gitlab developers recommend using unix sockets. You can change to
+using unix sockets by changing the following configuration files.
+
+ /etc/redis/redis.conf and /etc/gitlab/resque.yml
+
+2. wiki backend: debian package uses gollum-rugged_adapter whereas gitlab
+upstream still use gollum-grit_adapter. grit is no longer maintained and grit
+developers recommend switching to rugged. gollum-lib developers have announced
+their intention to switch to rugged_adapter by default and this is in progress.
+
+3. default paths: see /etc/gitlab/gitlab-debian.conf
+
+4. database: gitlab package configures postgresql database with peer
+authentication.
+
+5. gem versions: some gem dependency requirements are relaxed to work with
+their packaged version in debian.
+
+6. vendored js files: some embedded javascript files in vendor/assets/javascripts are
+replaced by their packaged verion.
diff --git a/debian/gitlab.docs b/debian/gitlab.docs
new file mode 100644
index 0000000000..389dbb95e0
--- /dev/null
+++ b/debian/gitlab.docs
@@ -0,0 +1,2 @@
+README.md
+debian/README.Debian