WikiSuite | How to install WikiSuite

If you are a developer, you may prefer to go directly to the source code.

As of 2021-01-04, this is ready for testing.

Virtualmin 95% optimally installed: we are tweaking script to pre-install / pre-configure more less common use cases like OCR. Uses PHP 7.4 (overrideable)
Elasticsearch installs fine: ready for testing
Tiki Manager installs well with instructions below. A script is in the works to automate: https://gitlab.com/wikisuite/tiki-manager-for-virtualmin
Tiki Wiki CMS Groupware installs well with 21.x LTS with instructions below. Once Tiki Manager is ready, instructions will be simplified.
Syncthing: Script is in the works: https://gitlab.com/wikisuite/syncthing-for-virtualmin/
Openfire script will be last because it's more complex.
MeshCentral will become a priority once we have integration with Tiki. Likely 2021Q3.

Requirements

A server
- A virtual machine will do fine. https://www.vpsbenchmarks.com/ can help you pick a provider.
- At least 1 gig of RAM
A domain name (a sub-domain will do fine)

Set up your domain name

You should point your domain name(s) to your server before your proceed. Even better is to point a wildcard subdomain. For example, we want all traffic to dev1.wikisuite.org or *.dev1.wikisuite.org as this makes it easy to create many projects, such as

abc.dev1.wikisuite.org
def.dev1.wikisuite.org
etc.

You'll want something like this:

dev1	A record	(put your IP address here)
*.dev1	CNAME	dev1.wikisuite.org.

More info at Set up your domain name

How To Install Virtualmin

You should have a fresh instance of Ubuntu 20.04 LTS. It should work with Ubuntu 18.04 LTS and Debian 9 and 10 but this has not yet been tested. CentOS support is planned and we are following discussions about CentOS vs CentOS Stream support in Virtualmin

It is important that nothing else is installed on the server because Virtualmin will handle it. We'll use https://gitlab.com/wikisuite/virtualmin-installer/ to install Virtualmin which is then configured for optimal settings for WikiSuite.

Install Webmin and Virtualmin on Ubuntu OS
Download Virtualmin using the below script. It is basically a shell script that will handle rest of the installation once executed.

If you have an unreliable internet connection, you should use tmux or something similar. (So you can launch some commands, and they continue running even if you are disconnected)

Then:

This downloads the install script (which you can inspect)

curl -o install-virtualmin.sh https://gitlab.com/wikisuite/virtualmin-installer/-/raw/master/install-virtualmin.sh

This is to inspect the script (optional)

nano install-virtualmin.sh

This runs the install script

bash install-virtualmin.sh

A web URL will be provided after installation is complete, you can access the Virtualmin by the provided URL Ex: https://example.org:10000 (GUI is at port 10000)

Update your system to latest available packages

Updates the list of available packages and their versions

apt-get update

Installs newer versions of the packages you have

apt-get upgrade

If you get an offer to autoremove, do not do so.

root@:~# apt-get upgrade
Reading package lists... Done
Building dependency tree
Reading state information... Done
Calculating upgrade... Done
The following package was automatically installed and is no longer required:
  php7.4-mysql
Use 'apt autoremove' to remove it.

Install Tiki Manager for Virtualmin

This installs or updates the Tiki Manager for Virtualmin installer (then available to each Virtualmin Server)

curl -o /usr/share/webmin/virtual-server/scripts/tikimanager.pl https://gitlab.com/wikisuite/tiki-manager-for-virtualmin/-/raw/master/tikimanager.pl

You have a basic server. Congrats!

This could be a good time to reboot your server, and make sure it restarts fine.

reboot

You will get kicked out. So now reconnect.

Next steps:

Create a Virtual Server
Install Tiki Manager
Use Tiki Manager to install Tiki Wiki CMS Groupware

Create Virtual Servers

Go to Ex: https://example.org:10000
Virtualmin > Create Virtual Server
For more info: https://www.virtualmin.com/documentation/tutorial/virtual-server-basics
Server Create

Suppose your desired domain is example.org, use the following pattern:
Create a Virtual Server for manager.example.org
And then, a Sub-Server for example.org

Top-level Virtual Server

Domain name (This will be for Tiki Manager): manager.example.org
Administration username (pick a descriptive word for that domain): example
Administration password: Set a Strong Password (if not, you will very likely get hacked)

Sub-server

Domain name (This will be for your site): example.org
No need to pick username and password like above because user you created can access both.

If a domain name is valid, free SSL (for https://) certificates from Let's Encrypt are automatically created.

So now, you should be able to visit both manager.example.org and example.org and see a placeholder page. If domain name is not set up, you can Preview Website via Virtualmin

Why not have example.org as the Virtual Server and manager.example.org as the Sub-Server? You could but it makes things more complicated later

Virtualmin has many other features like domain alias, domain rename, etc.

Installation of Tiki Manager

For more info, please see Tiki Manager docs.

1. Install Tiki Manager
Go to Ex: https://example.org:10000
Virtualmin > manager.example.org

Once the installation is complete, it will indicate your login URL. Ex.: http://manager.example.org

Tiki Manager's web interface

More info: Documentation of Tiki Manager's web UI

Virtualmin > file manager > Home > example > public_html
So now Tiki Manager will be accessible at manager.example.org

As of 2021-01-09, the web interface can't be used to install Tiki on Virtualmin (it assumes you are using root user for MySQL, which is not the case). Until this is resolved, you need to use the command line interface to install. However, you can use the web interface for other operations like upgrades and backups.