summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorYorick Peterse <yorickpeterse@gmail.com>2017-05-11 13:56:39 +0200
committerYorick Peterse <yorickpeterse@gmail.com>2017-05-11 13:58:16 +0200
commit2ee35a34edb9e617cc5bf8e5ceaceeeae12a61f0 (patch)
treec60b008032ca5d8e3809df804eba5cf73b8c6967
parent2e92c5c458cededd4f51a00b3849bf3cbb326b6b (diff)
downloadgitlab-ce-2ee35a34edb9e617cc5bf8e5ceaceeeae12a61f0.tar.gz
Update DB requirements in the documentationupdate-database-requirements
This makes it more obvious that we greatly prefer PostgreSQL over MySQL/MariaDB and that all users are recommended to use PostgreSQL instead. This also removes the paragraph mentioning the size per user row, as this is completely inaccurate and doesn't really help users with anticipating the database size. Instead we now simply recommend users to have at least 5-10 GB of storage at minimum. [ci skip]
-rw-r--r--doc/install/requirements.md17
1 files changed, 12 insertions, 5 deletions
diff --git a/doc/install/requirements.md b/doc/install/requirements.md
index 35586091f74..148796b73d4 100644
--- a/doc/install/requirements.md
+++ b/doc/install/requirements.md
@@ -122,15 +122,22 @@ To change the Unicorn workers when you have the Omnibus package please see [the
We currently support the following databases:
-- PostgreSQL (recommended)
+- PostgreSQL
- MySQL/MariaDB
-If you want to run the database separately, expect a size of about 1 MB per user.
+We _highly_ recommend the use of PostgreSQL instead of MySQL/MariaDB as not all
+features of GitLab may work with MySQL/MariaDB. Existing users using GitLab with
+MySQL/MariaDB are advised to migrate to PostgreSQL instead.
+
+The server running the database should have _at least_ 5-10 GB of storage
+available, though the exact requirements depend on the size of the GitLab
+installation (e.g. the number of users, projects, etc).
### PostgreSQL Requirements
-As of GitLab 9.0, PostgreSQL 9.6 is recommended. Lower versions of PostgreSQL
-may work but primary testing and developement takes place using PostgreSQL 9.6.
+As of GitLab 9.0, PostgreSQL 9.2 or newer is required, and earlier versions are
+not supported. We highly recommend users to use at least PostgreSQL 9.6 as this
+is the PostgreSQL version used for development and testing.
Users using PostgreSQL must ensure the `pg_trgm` extension is loaded into every
GitLab database. This extension can be enabled (using a PostgreSQL super user)
@@ -165,4 +172,4 @@ about it, check the [Prometheus documentation](../administration/monitoring/prom
We support the current and the previous major release of Firefox, Chrome/Chromium, Safari and Microsoft browsers (Microsoft Edge and Internet Explorer 11).
-Each time a new browser version is released, we begin supporting that version and stop supporting the third most recent version. \ No newline at end of file
+Each time a new browser version is released, we begin supporting that version and stop supporting the third most recent version.