Files
SCM-Manager/docs/en/first-startup/index.md

48 lines
2.6 KiB
Markdown
Raw Normal View History

---
title: First Startup
subtitle: Administration User Creation
---
# First Startup
On first startup, you have to create the initial administration user. Therefore, you need the token from the log.
This log looks something like this:
```
2021-06-22 09:19:43.166 [main] [ ] WARN sonia.scm.lifecycle.AdminAccountStartupAction - ====================================================
2021-06-22 09:19:43.166 [main] [ ] WARN sonia.scm.lifecycle.AdminAccountStartupAction - == ==
2021-06-22 09:19:43.166 [main] [ ] WARN sonia.scm.lifecycle.AdminAccountStartupAction - == Startup token for initial user creation ==
2021-06-22 09:19:43.166 [main] [ ] WARN sonia.scm.lifecycle.AdminAccountStartupAction - == ==
2021-06-22 09:19:43.166 [main] [ ] WARN sonia.scm.lifecycle.AdminAccountStartupAction - == LAh8BzNE68y2fj8Hj9lZ ==
2021-06-22 09:19:43.166 [main] [ ] WARN sonia.scm.lifecycle.AdminAccountStartupAction - == ==
2021-06-22 09:19:43.166 [main] [ ] WARN sonia.scm.lifecycle.AdminAccountStartupAction - ====================================================
```
When you open the SCM-Manager URL in a browser, you will see the creation form:
![Creation form for initial administration user](assets/initialization-form.png)
Enter the token from the log in the first input field and specify the username, the display name, the email address and
the password for the administration user and click the "Submit" button. When the administration user has been created,
the page will reload, and you will see the login dialog of SCM-Manager.
The password of the administration user cannot be recovered.
# Bypass User Creation Form
For automated processes, you might want to bypass the initial user creation. To do so, you can set the initial password
in a system property `scm.initialPassword`. If this is present, a user `scmadmin` with this password will be created,
if it does not already exist. To change the name of this user, you can set this with the property `scm.initialUser`
in addition.
When set, this also causes the initialization to skip the Plugin Wizard.
# Plugin Wizard
Once an initial user is created, the Plugin Wizard is going to appear.
Here you can select a series of pre-defined sets of plugins to kickstart
your development experience with the SCM-Manager. To install the selected
plugins, the server has to restart once.
![Form to select plugin sets](assets/plugin-wizard.png)