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 1: / Line 1: @@
+<noinclude><div style="display:none;">
+{{#vardefine:DB|{{#urlget:db|postgres}}}}
+{{#vardefine:mode|{{#urlget:mode|production}}}}
+{{#vardefine:mode_prefix|{{#ifeq: {{#var:mode}}|development||RAILS_ENV={{#var:mode}} <nowiki/>}}}}
+{{#vardefine:env_string|{{#var:mode_prefix}}}}}}
+</div></noinclude>
 == Versions of this guide ==
@@ Line 10: / 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. <!-- see table above -->
+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>
 The current guide is for a '''{{#switch: {{#var:mode}}|production=production|development=development}}''' setup
 with  '''{{#switch: {{#var:DB}}|mysql=MySQL|postgres=PostgreSQL|mariadb=MariaDB}}''' as database.
@@ Line 19: / Line 24: @@
 You can change them below:
-Running mode: {{#ifeq: {{#var:mode}}|production|'''Production'''|[[{{FULLPAGENAME}}?db={{#var:DB}}&mode=production|Production]]}} | {{#ifeq: {{#var:mode}}|development|'''Development'''|[[{{FULLPAGENAME}}?db={{#var:DB}}&mode=development|Development]]}}<br />
+Running mode: {{#ifeq: {{#var:mode}}
-Database: {{#ifeq: {{#var:DB}}|mysql|'''MySQL'''|[[{{FULLPAGENAME}}?db=mysql&mode={{#var:mode}}|MySQL]]}} {{!}} {{#ifeq: {{#var:DB}}|postgres|'''PostgreSQL'''|[[{{FULLPAGENAME}}?db=postgres&mode={{#var:mode}}|PostgreSQL]]}} {{#ifeq: {{#var:dist}}{{#var:version}}|UbuntuPrecise||{{!}} {{#ifeq: {{#var:DB}}|mariadb|'''MariaDB'''|[[{{FULLPAGENAME}}?db=mariadb&mode={{#var:mode}}|MariaDB]]}}}}
+| 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>
+}}<br />
+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}}
+| 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  (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>