Installing Sympl: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
|||
| (14 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
There are a | There are a few ways of installing Sympl. You will need a [[Debian]] or [[Raspberry Pi OS]] server running Buster (10), Bullseye (11) or Bookworm (12), and root access to the server. We suggest the server is freshly re-imaged, with only minimal packages installed on it and a correctly configured hostname. | ||
== | ==Imaged Install== | ||
If you're using a virtual server from [https://www.mythic-beasts.com Mythic Beasts], you can use their automatic installer to install Sympl and set most things up for you.<blockquote>See ''[[Installing Sympl on Mythic Beasts]]'' for more information.</blockquote> | |||
There is a basic auto-install script which can be used to install Sympl with minimal intervention | ==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 == | ===Install Stable/Production Version=== | ||
<pre>wget https://gitlab. | <pre>wget https://gitlab.com/sympl.io/install/-/raw/master/install.sh</pre> | ||
<pre>bash install.sh</pre> | <pre>bash install.sh</pre><br /> | ||
===Install Beta/Testing Version=== | |||
<pre>wget https://gitlab.com/sympl.io/install/-/raw/master/install.sh</pre> | |||
<pre>bash install.sh --testing</pre> | |||
===Non Interactive Install=== | |||
The install script supports a non-interactive install, with the <code>--noninteractive</code> 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 https://wiki.sympl.io/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== | ||
Alternatively, you can install manually: | Alternatively, you can install manually: | ||
<pre>apt install wget gnupg</pre> | |||
<pre>wget -qO- http://mirror.mythic-beasts.com/mythic/support@mythic-beasts.com.gpg.key | apt-key add -</pre> | <pre>wget -qO- http://mirror.mythic-beasts.com/mythic/support@mythic-beasts.com.gpg.key | apt-key add -</pre> | ||
<pre>echo deb http://packages.mythic-beasts.com/mythic/ | <pre>echo deb http://packages.mythic-beasts.com/mythic/ $(grep '^VERSION_CODENAME' /etc/os-release | cut -d'=' -f2) main > /etc/apt/sources.list.d/sympl_mythic-beasts.list</pre> | ||
<pre>apt-get update</pre> | <pre>apt-get update</pre> | ||
<pre>apt-get install --install-recommends sympl-core</pre> | <pre>apt-get install --install-recommends sympl-core</pre> | ||
You will be prompted for a number of things during the install - | 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: | ||
{| class="wikitable" | |||
|- | |||
!Prompt!!Answer | |||
|- | |||
|Configuring roundcube-core: Configure database for roundcube with dbconfig-common?||<code>Yes</code> | |||
|- | |||
|Configuring roundcube-core: Database type to be used by roundcube||<code>MySQL</code> | |||
|- | |||
|Configuring roundcube-core: Host running the server for roundcube||<code>localhost</code> | |||
|- | |||
|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?||<code>Yes</code> | |||
|- | |||
|Configuring phpmyadmin: Host running the MySQL server for phpmyadmin||<code>localhost</code> | |||
|- | |||
|Configuring phpmyadmin: Web server to reconfigure automatically||<code>apache2</code> | |||
|- | |||
|Configuring phpmyadmin: Perform upgrade on database for phpmyadmin with dbconfig-common?||<code>yes</code> | |||
|- | |||
|Configuring libc6:amd64: Restart services during package upgrades without asking?||<code>Yes</code> | |||
|- | |||
|Configuration file /etc/sysctl.conf modified since installation||<code>Install the package maintainer's version</code> | |||
|- | |||
|Configuring openssh-server||<code>Install the package maintainer's version</code> | |||
|- | |||
|Configuring grub-pc||<code>Keep the local version currently installed</code> | |||
|- | |||
|Configuration file /etc/ntp.conf modified since installation||<code>Keep your currently-installed version</code> | |||
|- | |||
|Configuration file /etc/phpmyadmin/config.inc.php modified since installation||<code>Install the package maintainer’s version</code> | |||
|- | |||
|Configuring unattended-upgrades||<code>Install the package maintainer’s version</code> | |||
|} | |||
Remember to set the new 'sympl' users password with <code>passwd sympl</code> once you have installed. | Remember to set the new 'sympl' users password with <code>passwd sympl</code> once you have installed. | ||
[[Category:Installation]] | |||
Revision as of 21:26, 9 November 2023
There are a few ways of installing Sympl. You will need a Debian or Raspberry Pi OS server running Buster (10), Bullseye (11) or Bookworm (12), and root access to the server. We suggest the server is freshly re-imaged, with only minimal packages installed on it and a correctly configured hostname.
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.com/sympl.io/install/-/raw/master/install.sh
bash install.sh
Install Beta/Testing Version
wget https://gitlab.com/sympl.io/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.io/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:
apt install wget gnupg
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/ $(grep '^VERSION_CODENAME' /etc/os-release | cut -d'=' -f2) 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.