doc(fix): typos and misses in README.md (#1)

Reviewed-on: https://codeberg.org/reflect/install/pulls/1
Co-authored-by: vlw <victor@vlw.se>
Co-committed-by: vlw <victor@vlw.se>
This commit is contained in:
Victor Westerlund 2025-08-07 08:34:34 +02:00 committed by Victor Westerlund
parent 288e7bde06
commit fb8d9a6929

View file

@ -10,12 +10,14 @@ A MariaDB or MySQL server with at least `SELECT` rights granted to a database ta
# Get started # Get started
1. Create a git repository for your project. 1. Create a git repository for your project.
2. Create a new empty MariaDB/MySQL database table. 2. Create a new empty MariaDB/MySQL database table.
3. Run this command from the root directory of your local repository. 3. Run this command from the root directory of your project.
```sh ```sh
curl -fsSL https://codeberg.org/reflect/install/raw/branch/master/install.sh | bash curl -fsSL https://codeberg.org/reflect/install/raw/branch/master/install.sh | bash
``` ```
4. Follow the steps in the installer. That's it!
# Arguments # Arguments
You can pass optional named arguments to this script for headless installation of Reflect. You can pass optional named arguments to this script for headless installation of Reflect.
@ -33,7 +35,7 @@ Pass `--overwrite=y` to overwrite all existing Reflect configuration files.
``` ```
Pass a `--dir` argument with a value of a directory Reflect should consider its [`root_path`](https://reflect.vlw.se/docs/Reference/Env#root_path). Pass a `--dir` argument with a value of a directory Reflect should consider its [`root_path`](https://reflect.vlw.se/docs/Reference/Env#root_path).
### `--endpoints` - Overwrite configuration files ### `--endpoints` - Reflect endpoint directory
```sh ```sh
./install.sh --endpoints="api" ./install.sh --endpoints="api"
``` ```
@ -45,7 +47,7 @@ Pass an `--endpoints` argument with a value of a directory relative to [`root_pa
```sh ```sh
./install.sh --db="reflect" ./install.sh --db="reflect"
``` ```
Pass a `--db` argument with a value of a database table that Reflect should use. Pass a `--db` argument with a value of a database table that Reflect should use when connecting to you MariaDB/MySQL server.
### `--host` - Reflect database hostname ### `--host` - Reflect database hostname
```sh ```sh
@ -59,12 +61,13 @@ Pass a `--host` argument with a value of a fully qualified hostname that Reflect
``` ```
Pass a `--user` argument with a value of a username that Reflect should use when connecting to you MariaDB/MySQL server. Pass a `--user` argument with a value of a username that Reflect should use when connecting to you MariaDB/MySQL server.
### `--password` - Reflect database user ### `--password` - Reflect database password
```sh ```sh
./install.sh --password="mypassword" ./install.sh --password="mypassword"
``` ```
Pass a `--password` argument with a value of a password that Reflect should use when connecting to you MariaDB/MySQL server. Pass a `--password` argument with a value of a password that Reflect should use when connecting to you MariaDB/MySQL server.
#### Disable password authentication
```sh ```sh
./install.sh --password=null ./install.sh --password=null
``` ```
@ -72,30 +75,25 @@ Pass "null" to this argument to disable password authentication
### Database seeding ### Database seeding
### `--db` - Reflect database table ### `--seed_host` - Database hostname for seeding
```sh
./install.sh --db="reflect"
```
Pass a `--db` argument with a value of a database table that Reflect should use.
### `--seed_host` - Reflect database hostname
```sh ```sh
./install.sh --seed_host="/path/to/project" ./install.sh --seed_host="/path/to/project"
``` ```
Pass a `--host` argument with a value of a fully qualified hostname that will be used by this script to seed the database. Pass a `--host` argument with a value of a fully qualified hostname that will be used by this script to seed the database.
### `--seed_user` - Reflect database user ### `--seed_user` - Database user for seeding
```sh ```sh
./install.sh --seed_user="www-data" ./install.sh --seed_user="www-data"
``` ```
Pass a `--user` argument with a value of a username that will be used by this script to seed the database. Pass a `--user` argument with a value of a username that will be used by this script to seed the database.
### `--seed_password` - Reflect database user ### `--seed_password` - Database password for seeding
```sh ```sh
./install.sh --seed_password="mypassword" ./install.sh --seed_password="mypassword"
``` ```
Pass a `--password` argument with a value of a password that will be used by this script to seed the database. Pass a `--password` argument with a value of a password that will be used by this script to seed the database.
#### Disable password authentication
```sh ```sh
./install.sh --seed_password=null ./install.sh --seed_password=null
``` ```