Nemcio/SCM-Manager
1
0
Fork 0
mirror of https://github.com/scm-manager/scm-manager.git synced 2026-01-05 07:09:48 +01:00
Code Issues Packages Projects Releases Activity

added debian installation instructions

Browse Source
This commit is contained in:
Sebastian Sdorra
2020-05-26 14:14:19 +02:00
parent c00714d3be
commit 8f7430bf1d
2 changed files with 73 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

70
docs/en/installation/debian.md Normal file
View File

@@ -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.

6
docs/en/installation/index.md
View File

@@ -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