Files
SCM-Manager/docs/getting-started.md
2020-03-31 17:28:30 +02:00

68 lines
2.3 KiB
Markdown

# Getting started
### Install Java
SCM-Manager needs an installed Java 1.7 or newer. It is recommended to
use the [oracle jre](http://java.oracle.com/). How to check
which version of Java is installed:
```bash
java -version
```
### Install the latest version of Java
Download java from [here](http://java.oracle.com/) and follow
the install instructions.
### Install SCM-Manager
Download the latest version of SCM-Manager from
[here](http://www.scm-manager.org/download/), unpack the .zip
or .tar.gz package and start SCM-Manager with
```bash
scm-server/bin/scm-server
```
### First access
| | |
| ------------ | ----------------------- |
| **URL** | <http://localhost:8080> |
| **Username** | scmadmin |
| **Password** | scmadmin |
### Mercurial
Subversion and Git will work out of the box, but if you want to use
mercurial with SCM-Manager you have to install mercurial version
**1.9** or newer.
#### Mercurial on Windows
The installation of mercurial for SCM-Manager is very complicated on
windows, have a look at:
- [#1](https://bitbucket.org/sdorra/scm-manager/issues/1/no-ability-to-rename-repository)
- [xeFcruG70s8J](https://groups.google.com/d/msg/scmmanager/zOigMIn2RiE/xeFcruG70s8J "Python/Hg Package Build Process")
- [build-win-hg-packages](https://bitbucket.org/sdorra/build-win-hg-packages)
SCM-Manager comes with the option to install packages for windows to
simplify this setup. To use such a package just login as Administrator,
goto \"Repository Types\", click the \"Start Configuration Wizard\" and
Choose \"Download and install\".
If you see an error like the following:
```text
sonia.scm.repository.RepositoryException: command exit with error 14001 and message: 'The application has failed to start because its side-by-side configuration is incorrect. Please see the application event log or use the command-line sxstrace.exe tool for more detail.'
```
Then you have to install [Microsoft Visual C++ 2008 SP1 Redistributable Package
(x86)](http://www.microsoft.com/en-us/download/details.aspx?id=5582).
Note you have to use the x86 package and not the x64 package, because we
use 32bit python in SCM-Manager on Windows. For more informations have a
look at
[#522](https://bitbucket.org/sdorra/scm-manager/issue/552/hg-repo-creation-failed).