GITBOOK-58: change request with no subject merged in GitBook

Author: alexjustesen

SUMMARY.md

@@ -11,7 +11,7 @@
   * [Using Synology](getting-started/installation/installation-1.md)
   * [Using Unraid](getting-started/installation/installation-2.md)
   * [Kubernetes](getting-started/installation/kubernetes.md)
-* [Database](getting-started/database.md)
+* [Database Drivers](getting-started/database-drivers.md)
 * [Environment Variables](getting-started/environment-variables.md)
 
 ## 🔑 Security

faqs.md

@@ -10,14 +10,9 @@ description: A running list of frequently ask questions and their answers.
 
 <summary>Using SQLite</summary>
 
-SQLite is supported by Laravel as a database driver but it is no longer the recommended driver for this project. To setup SQLite as your database driver of choice use the directions below.
+SQLite is supported by Laravel as a database driver but it is not the default or recommended driver for this project. To setup SQLite as your database driver of choice use the directions below.
 
-`v0.11.22` dropped SQLite support, to reconnect your existing database you can start on Step 3.
-
-1. Create a volume called `speedtest-tracker` and attach it to the container.
-2. Create a file called `database.sqlite`, you can do this by running `touch database.sqlite` in the mounted volume or create it in the mounted directory.
-3. Update your environment variables to only include the following for under the `DB_` prefix: `DB_CONNECTION=sqlite` and `DB_DATABASE=/config/database.sqlite`.
-4. Restart the container.
+Directions for using SQLite can now be found on the [Database Drivers](getting-started/database-drivers.md) page.
 
 </details>
 

getting-started/database-drivers.md

@@ -0,0 +1,54 @@
+# Database Drivers
+
+Since Speedtest Tracker is built on the Laravel Framework any of the framework's supported database [drivers](https://laravel.com/docs/10.x/database#configuration) are also supported.
+
+MySQL/MariaDB ships as the default driver but you can also use SQLite and Postgres. While SQL Server is supported by Laravel it hasn't been tested with Speedtest Tracker so no support will be provided for that driver.
+
+***
+
+### Driver Options
+
+#### MySQL/MariaDB (Default, recommended)
+
+MariaDB ships as the default database that's included in the `docker-compose.yml` configuration, it's functionally the same as MySQL just an open-source earlier fork.
+
+| Environment Variable | Value                                                                                                          |
+| -------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `DB_DRIVER`          | <p><code>mysql</code>  </p><p></p><p>The <code>mysql</code> driver can be used for both MySQL and MariaDB.</p> |
+| `DB_HOST`            | The FQDN or address to the database instance.                                                                  |
+| `DB_PORT`            | `3306` is the default port but can depend on your setup.                                                       |
+| `DB_DATABASE`        | Name of the database you'll connect to.                                                                        |
+| `DB_USERNAME`        | User that'll be used to connect to the database.                                                               |
+| `DB_PASSWORD`        | Password for the user above.                                                                                   |
+
+#### SQLite
+
+SQLite is a good option for simple installs and only not recommended because I think separating your application and the database into separate services is a better idea.
+
+To use SQLite follow the steps below to create your database file:&#x20;
+
+1. Create a volume called `speedtest-tracker` or mount a directory to the container.
+2. Create a file called `database.sqlite`, you can do this by running `touch database.sqlite` in the mounted volume or create it in the mounted directory.
+3. Update your environment variables to only include the following environment variables in the table below.
+
+| Environment Variable | Value                                                                             |
+| -------------------- | --------------------------------------------------------------------------------- |
+| `DB_DRIVER`          | `sqlite`                                                                          |
+| `DB_DATABASE`        | This should be the path to your SQLite database (i.e. `/config/database.sqlite`). |
+
+#### Postgres
+
+| Environment Variable | Value                                                    |
+| -------------------- | -------------------------------------------------------- |
+| `DB_DRIVER`          | `pgsql`                                                  |
+| `DB_HOST`            | The FQDN or address to the database instance.            |
+| `DB_PORT`            | `5432` is the default port but can depend on your setup. |
+| `DB_DATABASE`        | Name of the database you'll connect to.                  |
+| `DB_USERNAME`        | User that'll be used to connect to the database.         |
+| `DB_PASSWORD`        | Password for the user above.                             |
+
+#### SQL Server
+
+While supported by the framework it's drivers are not installed in the base image, if you want to use SQL Server you should extend the base image.
+
+Laravel docs: [https://laravel.com/docs/10.x/database#mssql-configuration](https://laravel.com/docs/10.x/database#mssql-configuration)