Installing Sympl: Difference between revisions

From Sympl Wiki
Jump to navigation Jump to search
No edit summary
Tag: visualeditor
No edit summary
Tag: visualeditor
Line 1: Line 1:
There are a few ways of installing Sympl. You will need a [[Debian]] Linux server running Stretch (9) or Buster (10), and root access to the server. We suggest the server is freshly re-imaged, with only minimal things installed on it.
There are a few ways of installing Sympl. You will need a [[Debian]] or [[Raspberry Pi OS]] server running Stretch (9) or Buster (10), and root access to the server. We suggest the server is freshly re-imaged, with only minimal packages installed on it.


==Imaged Install==
==Imaged Install==
Line 9: Line 9:
===Install Stable/Production Version===
===Install Stable/Production Version===
<pre>wget https://gitlab.mythic-beasts.com/sympl/install/raw/master/install.sh</pre>
<pre>wget https://gitlab.mythic-beasts.com/sympl/install/raw/master/install.sh</pre>
<pre>bash install.sh</pre>If you get an error message saying "E: gnupg, gnupg2 and gnupg1 do not seem to be installed, but one of them is required for this operation" then you will need to install gnupg. To do this:
<pre>bash install.sh</pre><br />
sudo apt-get update
and
sudo apt-get install gnupg
 
===Install Beta/Testing Version===
===Install Beta/Testing Version===
<pre>wget https://gitlab.mythic-beasts.com/sympl/install/raw/master/install.sh</pre>
<pre>wget https://gitlab.mythic-beasts.com/sympl/install/raw/master/install.sh</pre>
Line 21: Line 17:
The install script supports a non-interactive install, with the <code>--noninteractive</code> switch.
The install script supports a non-interactive install, with the <code>--noninteractive</code> switch.


This disabled the normal 5 second delay, as the banner, 'important information' and password change.
This disables the normal 5 second delay before installing.


If using this in an automated script, please ensure that users are pointed to the URL https://wiki.sympl.host/Get_Started for documentation, suggest they update the password for the <code>sympl</code> user as soon as possible.
If using this in an automated script, please ensure that users are pointed to the URL https://wiki.sympl.host/Get_Started and are made aware of the file <code>README_SYMPL.txt</code> in the root adn sympl users home directories for documentation, and strongly suggest they update the password for the <code>sympl</code> user as soon as possible.


==Manual Install==
==Manual Install==

Revision as of 14:24, 21 August 2020

There are a few ways of installing Sympl. You will need a Debian or Raspberry Pi OS server running Stretch (9) or Buster (10), and root access to the server. We suggest the server is freshly re-imaged, with only minimal packages installed on it.

Imaged Install

If you're using a virtual server from Mythic Beasts, you can use their automatic installer to install Sympl and set most things up for you.

See Installing Sympl on Mythic Beasts for more information.

Automatic Install

There is a basic auto-install script which can be used to install Sympl with minimal intervention and point the user to important resources.

Install Stable/Production Version

wget https://gitlab.mythic-beasts.com/sympl/install/raw/master/install.sh
bash install.sh


Install Beta/Testing Version

wget https://gitlab.mythic-beasts.com/sympl/install/raw/master/install.sh
bash install.sh --testing

Non Interactive Install

The install script supports a non-interactive install, with the --noninteractive switch.

This disables the normal 5 second delay before installing.

If using this in an automated script, please ensure that users are pointed to the URL https://wiki.sympl.host/Get_Started and are made aware of the file README_SYMPL.txt in the root adn sympl users home directories for documentation, and strongly suggest they update the password for the sympl user as soon as possible.

Manual Install

Alternatively, you can install manually:

wget -qO- http://mirror.mythic-beasts.com/mythic/support@mythic-beasts.com.gpg.key | apt-key add -
echo deb http://packages.mythic-beasts.com/mythic/ stretch main > /etc/apt/sources.list.d/sympl_mythic-beasts.list
apt-get update
apt-get install --install-recommends sympl-core

You will be prompted for a number of things during the install. Depending on the state of your system, some of these may not be asked or may be in another order:

Prompt Answer
Configuring roundcube-core: Configure database for roundcube with dbconfig-common? Yes
Configuring roundcube-core: Database type to be used by roundcube MySQL
Configuring roundcube-core: Host running the server for roundcube localhost
Configuring roundcube-core: Password of the database’s administrative user Leave Blank
Configuring roundcube-core: MySQL application password for roundcube Leave Blank
User preference (Leave blank to generate a random password) Leave Blank
Configuring phpmyadmin: Configure database for phpmyadmin with dbconfig-common? Yes
Configuring phpmyadmin: Host running the MySQL server for phpmyadmin localhost
Configuring phpmyadmin: Web server to reconfigure automatically apache2
Configuring phpmyadmin: Perform upgrade on database for phpmyadmin with dbconfig-common? yes
Configuring libc6:amd64: Restart services during package upgrades without asking? Yes
Configuration file /etc/sysctl.conf modified since installation Install the package maintainer's version
Configuring openssh-server Install the package maintainer's version
Configuring grub-pc Keep the local version currently installed
Configuration file /etc/ntp.conf modified since installation Keep your currently-installed version
Configuration file /etc/phpmyadmin/config.inc.php modified since installation Install the package maintainer’s version
Configuring unattended-upgrades Install the package maintainer’s version

Remember to set the new 'sympl' users password with passwd sympl once you have installed.