Template:Installation/GuideVersion: Difference between revisions

Latest revision as of 00:57, 2 August 2022

Versions of this guide

Warning:

Make sure to use the correct version of the guide, see below.

» Help me decide!

In Production mode, your pod is configured to deal with high load for everyday usage. This is recommended for a pod you want to actually use.

In Development mode, your pod is configured for development. This is recommended ony for development contributors of diaspora* which use the pod only locally for testing purposes.

For Database, choose PostgreSQL unless you already have an existing database server that you want to re-use. We recommend an isolated PostgreSQL installation exclusively for your pod.

The current guide is for a production setup with PostgreSQL as database.

You can change them below:

Running mode: Production | Development

Database: PostgreSQL | MySQL (deprecated) | MariaDB (deprecated)

@@ Line 16: / Line 16: @@
 In '''Development''' mode, your pod is configured for development. This is recommended ony for development contributors of diaspora* which use the pod only locally for testing purposes.
-The '''Database''' you choose is up to you. In our experience PostgreSQL achieves a better performance but needs more resources.
+For '''Database''', choose PostgreSQL unless you already have an existing database server that you want to re-use. We recommend an isolated PostgreSQL installation exclusively for your pod.
 </div>
 </div>
@@ Line 25: / Line 25: @@
 Running mode: {{#ifeq: {{#var:mode}}
-|production|'''Production'''|<span class="plainlinks">[{{fullurl:{{FULLPAGENAME}}}}?db={{#var:DB}}&mode=production#Versions_of_this_guide Production]</span>
+| production
+  | '''Production'''
+  | <span class="plainlinks">[{{fullurl:{{FULLPAGENAME}}}}?db={{#var:DB}}&mode=production#Versions_of_this_guide Production]</span>
 }} | {{#ifeq: {{#var:mode}}
-|development|'''Development'''|<span class="plainlinks">[{{fullurl:{{FULLPAGENAME}}}}?db={{#var:DB}}&mode=development#Versions_of_this_guide Development]</span>
+| development
+  | '''Development'''
+  | <span class="plainlinks">[{{fullurl:{{FULLPAGENAME}}}}?db={{#var:DB}}&mode=development#Versions_of_this_guide Development]</span>
 }}<br />
-Database: {{#ifeq: {{#var:DB}}
-|mysql|'''MySQL'''|<span class="plainlinks">[{{fullurl:{{FULLPAGENAME}}}}?db=mysql&mode={{#var:mode}}#Versions_of_this_guide MySQL]</span>
+Database:
+{{#ifeq: {{#var:DB}}
+| postgres
+  | '''PostgreSQL'''
+  | <span class="plainlinks">[{{fullurl:{{FULLPAGENAME}}}}?db=postgres&mode={{#var:mode}}#Versions_of_this_guide PostgreSQL]</span>
 }} {{!}} {{#ifeq: {{#var:DB}}
-|postgres|'''PostgreSQL'''|<span class="plainlinks">[{{fullurl:{{FULLPAGENAME}}}}?db=postgres&mode={{#var:mode}}#Versions_of_this_guide PostgreSQL]</span>
+| mysql
+  | '''MySQL  (deprecated)'''
+  | <span class="plainlinks">[{{fullurl:{{FULLPAGENAME}}}}?db=mysql&mode={{#var:mode}}#Versions_of_this_guide MySQL] (deprecated)</span>
 }} {{#ifeq: {{#var:dist}}{{#var:version}}|UbuntuPrecise||{{!}} {{#ifeq: {{#var:DB}}
-|mariadb|'''MariaDB'''|<span class="plainlinks">[{{fullurl:{{FULLPAGENAME}}}}?db=mariadb&mode={{#var:mode}}#Versions_of_this_guide MariaDB]</span>
+| mariadb
+  | '''MariaDB  (deprecated)'''
+  | <span class="plainlinks">[{{fullurl:{{FULLPAGENAME}}}}?db=mariadb&mode={{#var:mode}}#Versions_of_this_guide MariaDB] (deprecated)</span>
 }}}}
+{{#ifeq: {{#var:DB}}|mysql|{{Serious|You have selected MySQL as your preferred database engine. While diaspora* still supports MySQL-based setups, MySQL support is deprecated, and new pods are strongly encouraged to use PostgreSQL instead.}}|}}
+{{#ifeq: {{#var:DB}}|mariadb|{{Serious|You have selected MariaDB as your preferred database engine. While diaspora* still supports MariaDB-based setups, MariaDB support is deprecated, and new pods are strongly encouraged to use PostgreSQL instead.}}|}}
 <noinclude>[[Category:Installation-Templates]]</noinclude>