From 8f7430bf1d6cbf4ef608b68f5c6c03e41fdbe8a5 Mon Sep 17 00:00:00 2001
From: Sebastian Sdorra <sebastian.sdorra@cloudogu.com>
Date: Tue, 26 May 2020 14:14:19 +0200
Subject: [PATCH] added debian installation instructions

---
 docs/en/installation/debian.md | 70 ++++++++++++++++++++++++++++++++++
 docs/en/installation/index.md  |  6 +--
 2 files changed, 73 insertions(+), 3 deletions(-)
 create mode 100644 docs/en/installation/debian.md

diff --git a/docs/en/installation/debian.md b/docs/en/installation/debian.md
new file mode 100644
index 0000000000..400ff6bb11
--- /dev/null
+++ b/docs/en/installation/debian.md
@@ -0,0 +1,70 @@
+---
+title: Debian
+subtitle: Installation for debian based linux distributions
+---
+
+## Quickstart
+
+The following code block will configure an apt repository for scm-manager and install it.
+
+```bash
+echo 'deb https://packages.scm-manager.org/repository/apt-v1-releases/ stable main' | sudo tee /etc/apt/sources.list.d/scm-manager.list
+sudo apt-key adv --recv-keys --keyserver hkps://keys.openpgp.org 0x975922F193B07D6E
+sudo apt-get update
+sudo apt-get install scm-server
+```
+
+After the installation of the package scm-manager will automatically start on port 8080.
+The default username is `scmadmin` with the password `scmadmin`.
+
+## Detailed installation
+
+To install SCM-Manager as a debian package (.deb), we have to configure an apt repository.
+Create a file at `/etc/apt/sources.list.d/scm-manager.list` with the following content:
+
+```text
+deb https://packages.scm-manager.org/repository/apt-v2-releases/ stable main
+```
+
+This will add the apt repository of the scm-manager stable releases to the list of your apt repositories.
+To ensure the integrity of the debian packages we have to import the gpg key for the repository.
+
+```bash
+sudo apt-key adv --recv-keys --keyserver hkps://keys.openpgp.org 0x975922F193B07D6E
+```
+
+After we have imported the gpg key, we can update the package index and install scm-manager:
+
+```bash
+sudo apt-get update
+sudo apt-get install scm-server
+```
+
+The package will configure a systemd service called scm-server.
+The service is enabled and started with installation of the package.
+After the service is started, scm-manager should be reachable on port 8080
+The default username is `scmadmin` with the password `scmadmin`.
+
+## Troubleshooting
+
+If the service does not start have a look at the systemd journal:
+
+```bash
+journalctl -u scm-server
+```
+
+For further information have a look at the scm-manager logs at `/var/log/scm`.
+
+## Home directory
+
+SCM-Manager stores all its information in its home directory at `/var/lib/scm`.
+
+## Configuration
+
+Most of the configuration of scm-manager can be configured via the web interface.
+But the startup and the web server configuration must be configured via configuration files.
+The default configuration of the debian package should match 90% of the use cases,
+if you have to change something ensure you know what you are doing.
+
+To configure the startup have a look at `/etc/default/scm-server`.
+To configure logging and the webserver, `/etc/scm` is the right place.
diff --git a/docs/en/installation/index.md b/docs/en/installation/index.md
index 952c1bd178..12b07a66bd 100644
--- a/docs/en/installation/index.md
+++ b/docs/en/installation/index.md
@@ -4,10 +4,10 @@ subtitle: Installation of scm-manager
 partiallyActive: true
 ---
 
-* [Docker](docker/)
-* Kubernetes
-* Debian based
+* [Debian based](debian/)
 * Red Hat based
 * [Linux General](linux/)
+* [Docker](docker/)
+* Kubernetes
 * Mac OS X
 * Windows