---
tags: Testing
---

# Installation Documentation Improvements Testing Instructions for Release v0.1.2

# Instructions for testers common to all testing scenarios:

### What is expected from the Tester
- For each scenario, we would like the tester to read through our documentation and try to install the project on their own server based on the scenario requirement and submit a feedback document. The submitted feedback document should contain
- All the steps performed
- Errors faced when installing the project
- Suggestions to improve the documentation in terms of clarity, completeness, accuracy, and ease of use for the end-user installation procedure

### Technical Instructions for testers
- The [Installation documentation](https://docs-testing.mathesar.org/installation/) to follow
- Testers can use any Linux variant(preferred Debian or Ubuntu)
- For testers using Docker-based installation steps. Before testing, run these commands:

docker image pull mathesar/mathesar-prod:0.1.2
docker image tag mathesar/mathesar-prod:0.1.2 mathesar/mathesar-prod:latest

# Mathesar Installation Testing Scenarios

## Install Mathesar using the docker-compose tool

##### Instructions for the tester
- Install Mathesar using the Docker compose Installation method on your server.
- Add your report to this [document](https://docs.google.com/document/d/1id2NtMf2KURkChg4SC79u-_vMkwPhdr3IFgUGb91L50/edit?usp=sharing)

##### Test success condition
- The test is a success if you can log in to Mathesar

## Localhost Database Installation

##### Instructions for the tester
- Set up the Postgres server on the localhost of the same machine you plan to install Mathesar on
- Ubuntu users - https://www.postgresqltutorial.com/postgresql-getting-started/install-postgresql-linux/
- Windows users - https://www.postgresqltutorial.com/postgresql-getting-started/install-postgresql/
- MacOS users - https://www.postgresqltutorial.com/postgresql-getting-started/install-postgresql-macos/
- Install Mathesar using the Docker compose Installation method and connect to the Postgres server running on your localhost
- Add your report to this [document](https://docs.google.com/document/d/19JcvLVRIX83EpfKh-JzPsgn0fcmDGdBR-ssIlUn4azw/edit?usp=sharing)

##### Test success condition
- The test is a success if you can log in to Mathesar and can access databases running on the Postgres server.

## Multiple database Installation

##### Instructions for the tester
- Set up the Postgres server on the localhost of the same machine you plan to install Mathesar on
- Ubuntu users - https://www.postgresqltutorial.com/postgresql-getting-started/install-postgresql-linux/
- Windows users - https://www.postgresqltutorial.com/postgresql-getting-started/install-postgresql/
- MacOS users - https://www.postgresqltutorial.com/postgresql-getting-started/install-postgresql-macos/
- Create databases called `library` and `restaurant` on the Postgres server.
- Install Mathesar using the Docker compose Installation method and connect to the Postgres server on your localhost.
- Add your report to this [document](https://docs.google.com/document/d/1sSLbKKfzlpZs9sTDzs9Xi4edj1vz1-HYed-DiZpHUPY/edit?usp=sharing)

##### Test success condition
- The test is a success if you can log in to Mathesar and can access the databases. If you have created databases called `library` and `restaurant`. You should be able to access them by visiting
- `https://<domain-name>/library`
- `https://<domain-name>/restaurant`

## Running Mathesar when the default Port is not accessible

##### Instructions for the tester
- Install Mathesar using the Docker compose installation method on your server and run Mathesar on port `8030`.
- Add your report to this [document](https://docs.google.com/document/d/1W8SEWDbAMZb-NFM0dNtWjJRmTykRTIRJT6fd0YQWPjc/edit?usp=sharing)

##### Test success condition
- The test is successful if you can log in to Mathesar by visiting `localhost:8030`.

## Build and Install Mathesar from the source

##### Instructions for the tester
- Install Mathesar by building it from the source code instead of using any pre-built Docker images.
- Add your report to this [document](https://docs.google.com/document/d/1V09tCZ-hs3fCk2PdysDbi2vSonT8hLmoeq49cI-87WY/edit?usp=sharing)

##### Test success condition
- The test is a success if you can log in to Mathesar.