Requirements

• A server
  • A virtual machine will do fine
  • 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 for 2021.

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.

Log in to your server via SSH with the root user. (If you are not logged in as root, you should switch to root)

Then run

# Run this Command on Terminal

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

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

apt-get update

apt-get upgrade

Create Virtual Servers

Virtualmin > Create Virtual Server

Domain name: Provide Domain To the virtual server
Administration password:Set a Strong Password

If domain name is valid, SSL certificates from Let's Encrypt are automatically created.

Installation of Tiki Manager

For more info, please see: https://doc.tiki.org/Manager

1. Install Tiki Manager :-
You can Install tiki-manager under any directory
Recomended Directory:- "home"

ie.

$ cd /home

$ mkdir tiki-manager

$ cd tiki-manager

$ git clone --depth 1 --branch master https://gitlab.com/tikiwiki/tiki-manager.git .

$ php tiki-manager.php manager:info

When asked "Enter passphrase (empty for no passphrase):", just click "Enter" unless you know that you need a passphrase (probably not)

Create Tiki Instance through CLI

instance:create
creates a fresh Tiki instance (including a database) fetching files from Git

For more info, please see:- https://doc.tiki.org/manager#instance

php tiki-manager.php instance:create ––type=local     ––Web Url=http://manager.tiki.org    ––name=manager.tiki.org     
––email=manager@example.org     ––webroot=/home/example/public_html  ––tempdir=/tmp/trim_temp    ––branch=branches/21.x    ––backup-user=www-data   ––backup-group=www-data     ––backup-permission=777      ––db-host=localhost     ––db-user=root    ––db-pass=secret   ––db-prefix=manager

Database setup(do this setup after selecting branch while creating instance)

Go to Virtualmin (http://example.org:10000 )

Webmin > Server > MySQL database server > user permission tab > Select user

• Set Password
• Give permission to all

and save it

After Successfully Creating tiki-instance

You will get the Tiki HomePage as below.

Tiki Admin Dashboard looks like.

Configure SSL

Virtualmin > Server Configuration > SSL certificate> Lets encrypt > Request certificate

Let's Encrypt is an open certificate authority that provides free SSL certificates. The app intelligently integrates the certificate lifecyle and management into Webconfig

To access the administration
{http://example.org/tiki-admin.php}

Control Panels > Security > General security >"check" Protect all sessions with HTTPS > Apply the changes

Setup Mail

Virtualmin > Edit User > Add a new user to this server

Configure email account to Tiki's webmail

For more info, please see: https://doc.tiki.org/Webmail

To access Control panel
https://example.org/tiki-admin.php

Control Panel > click on advance button > enable Webmail

or

To access Webmail

http://example.org/tiki-admin.php?page=webmail

Webmail

The webmail feature can be used to offer a web-based interface to your users webmail accounts, note that Tiki is not a mail server, your users should already have email addresses before being able to use webmail. Any POP3 accessible mail account can be used from Tiki.

Configuring webmail accounts

After enabling webmail from the features section of the admin panel you will be able to enter the webmail section from the application menu. In your first visit to the webmail you will be automatically redirected to the webmail configuration panel.

Configure SMTP Server
By default Tiki Manager uses sendmail to send email notifications. If you intend to use SMTP instead add the following lines to your .env file.
Virtualmin > file manager > Home > tiki-manager > .env dist

SMTP_HOST=<SERVER_ADDRESS>
SMTP_PORT=<SERVER_PORT>
SMTP_USER=(optional if authentication is required)
SMTP_PASS=(optional if authentication is required)

TroubleShoot

The installer is locked!

When you attempt to load tiki-install.php in your browser, Tiki displays the message:

Installer disabled. Remove 'db/lock' to enable the installer.

To re-enable the install script, use your host's file management software to remove the file lock from your Tiki's ../db/ directory.

You can now re-run the install script.

Tiki Installer reports a Security Precaution.

When you attempt to load tiki-install.php in your browser, Tiki displays the Security Alert page:

To protect your site, if you (or anyone else) attempts to run the Tiki installer on a site that has an existing Tiki database, Tiki displays the security precaution alert and requires you to login using your database's username and password.

Enter the database username and password that you used when creating the database.

✔ TIP
If you forgot these items, Tiki has recorded them in the [../db/local.php file].

If the tiki installer security precaution goes in loop after entering database username and password
please add the following command

$ php console.php database:update