Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added .github/resources/setup-wizard.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 4 additions & 0 deletions docs/getting-started/quick-start.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,10 @@ docker ps -f name=romm

Open `http://<host>:8080` in a browser. On first start, you'll be redirected to the **Setup Wizard**. Set an admin username and password (the first user created always gets the Admin role), then log in.

### Setup Wizard

![A screenshot of the RomM Setup Wizard](.github/resources/setup-wizard.png "A screenshot of the RomM Setup Wizard")

## Next steps

- Populate the library by [scanning the mounted ROMs](first-scan.md)
Expand Down
7 changes: 7 additions & 0 deletions docs/troubleshooting/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,13 @@ description: Diagnose common issues by symptom
- Database connection errors → verify `DB_HOST`/`DB_PASSWD` match your DB container, and that the DB has finished initialising (first run takes longer than you'd think).
- "Page not found" on first load → wait, because initial migrations and resource seeding take a minute.

## No Setup Wizard

- If you do not see the setup wizard upon first connecting, and instead see a login screen, first check to see if the version number in the bottom right is `0.0.0`. If it is, RomM is functional and accessible, but not configured correctly,
and you will not be able to login, no matter what username and password you try.
- Ensure that you have modified `path/to/library`,`path/to/assets`, and `path/to/configs` in your `docker-compose.yml` so that they point to directories on the host.
- `/romm/library`, `/romm/assets`, and `/romm/config` should remain unchanged, as these refer to directories inside the docker container itself.

## Login issues

- Getting 403s → [Authentication Troubleshooting](authentication.md)
Expand Down
Loading