Skip to content

Commit

Permalink
Adjust docs language
Browse files Browse the repository at this point in the history
  • Loading branch information
seancolsen committed Sep 7, 2023
1 parent 711a2b3 commit a766eac
Show file tree
Hide file tree
Showing 2 changed files with 8 additions and 6 deletions.
2 changes: 1 addition & 1 deletion docs/docs/installation/build-from-source/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ Then press <kbd>Enter</kbd> to customize this guide with your domain name.
!!! warning "Customize your password"
Be sure to change the password `1234` in the command above to something more secure and private. Record your custom password somewhere safe. You will need to reference it later.

1. Next, we have to create a database for storing Mathesar metadata. You either need to be a `SUPERUSER` or `OWNER` of the database. In this guide, we will be setting the user to be `OWNER` of the database as it is slightly restrictive compared to a `SUPERUSER`.
1. Next, we have to create a database for storing Mathesar metadata. Your PostgreSQL user will either need to be a `SUPERUSER` or `OWNER` of the database. In this guide, we will be setting the user to be `OWNER` of the database as it is slightly restrictive compared to a `SUPERUSER`.

```postgresql
CREATE DATABASE mathesar_django OWNER mathesar;
Expand Down
12 changes: 7 additions & 5 deletions docs/docs/installation/docker/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,9 +24,11 @@ You'll need to install **[Docker](https://docs.docker.com/desktop/)** v23+
#### Database for Mathesar's internal usage
You'll need to:

- Create a database user for Mathesar to use.
- Create a PostgreSQL database for Mathesar's internal usage owned by that database user, [see PostgreSQL docs for more information](https://www.postgresql.org/docs/13/ddl-priv.html)
- (OR) Make the user a `SUPERUSER`, [see PostgreSQL docs for more information](https://www.postgresql.org/docs/13/sql-createrole.html) which will give the user access to all the databases
- Create or have a PostgreSQL user for Mathesar to use.
- Create a PostgreSQL database for Mathesar's internal usage owned by that database user. (See the PostgreSQL [docs](https://www.postgresql.org/docs/13/ddl-priv.html) for more information.)

Alternatively, you can make the user a `SUPERUSER` which will give the user access to all the databases. (See the see PostgreSQL [docs](https://www.postgresql.org/docs/13/sql-createrole.html) for more information.)

- Ensure that this database can accept network connections from the machine you're installing Mathesar on.
- Have the following information for this database handy before installation:
- Database hostname
Expand All @@ -44,8 +46,8 @@ Have the following information for all databases you'd like to connect to Mathes
- Database username (should be `SUPERUSER` or `OWNER` of the database, see above)
- Database password

!!! warning "Database creation"
Whenever the Docker container is started, we will attempt to create any databases in this list that don't already exist if the user has [`CREATEDB` privilege](https://www.postgresql.org/docs/13/sql-createrole.html). So you don't need to ensure that they are created before installation.
!!! info "Databases are automatically created"
You don't need to create these databases before installation. Whenever the Docker container is started, Mathesar will attempt to create any specified databases that don't already exist, so long as the user has [`CREATEDB` privilege](https://www.postgresql.org/docs/13/sql-createrole.html).

## Installation Steps

Expand Down

0 comments on commit a766eac

Please sign in to comment.