Loading...
 

History: How to install WikiSuite

Preview of version: 247

2021-09-09: The installation process was massively simplified with the introduction of https://gitlab.com/wikisuite/virtualmin-tikimanager

2021-10-14: We are working on creating .deb and .rpm packages


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

As of 2021-10-14, the status is

Requirements

  • A server, being physical host or a virtual machine. https://www.vpsbenchmarks.com/ can help you pick a provider.
    • CPU
      • 1 core/thread is enough for a fresh website but we suggest to consider at least 2. And scale accordingly in the future.
    • RAM
      • To run Virtualmin and a few small Tiki instances, you should have at least 1GB of RAM. But as word goes, the more the better..
    • STORAGE
      • 10GB can get you started with an OS and everything you need. But you should get more or even over-provision if you plan for an intensive online activity with lots of files.
      • Do not forget about backups: start locally and move to remote as soon as possible. Virtualmin can help you make the best out of your available space, by rotating backups.
  • A grade A GNU/Linux operating system, stable and suitable for servers
      • You need to pre-install a fresh minimal Debian 10 (soon 11) or Ubuntu 20.04 LTS (more distros will be supported later, Rocky Linux & CentOS 8.x are a given)
  • A domain name (a sub-domain will also do fine), with the following options:
      • At the moment it is recommended to delegate fully a working sub-domain or domain to the server before your proceed, because your WikiSuite server will run flawlesly a BIND nameserver. In this case you will have the advantages of creating subdomains easily, locally, also with SPF records for example. And it offers flexibility for any future domains.
      • You can also point a wildcard subdomain if you don't want to deal with DNS on your server. For example, if we want all requests pointed to test.wikisuite.org or *.test.wikisuite.org as this makes it easy to create many projects, such as: abc.test.wikisuite.org, def.test.wikisuite.org, etc.
      • Last but not least, for a single (sub)domain just a simple A record from your DNS provider pointed to your IP. This is provider-dependent and not covered here.


You'll want something like this:

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


More info at Set up your domain name

How WikiSuite leverages Virtualmin / Webmin

Webmin is a web tool to facilitate server management. Virtualmin extends Webmin with a focus on shared hosting, which allows multiple instances of Tiki Wiki CMS Groupware that are clearly segmented.

Installing WikiSuite automatically installs all the necessary packages and Webmin which itself automatically installs Virtualmin (both configured for optimal settings for WikiSuite components, see here the Differences from the original script ).

You should have a fresh instance of Debian 10 or Ubuntu 20.04 LTS. It should work with Ubuntu 18.04 LTS and Debian 9 but this has not yet been tested. CentOS and Rocky Linux support is planned and we are following discussions about CentOS vs CentOS Stream support in Virtualmin. Expect full support for Debian 11 once the Virtualmin team adapts their software suite.

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).

Getting started

Log in to your server via SSH with the root user. In some cases, your host may not provide you a root access to directly login to. This is why commands which require root are pre-fixed by sudo.

Then:

Always update first
sudo apt-get update && apt-get upgrade
This installs curl if not already installed
sudo apt-get install curl
Set a proper FQDN hostname for your machine
hostnamectl set-hostname machine.name
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
sudo bash install-virtualmin.sh

A web URL for accessing Virtualmin will be provided after installation is complete Ex: https://example.org:10000 (GUI is at port 10000)

If you are getting SSL errors: Virtualmin -> Select base domain -> Server Configuration -> SSL Certificate -> Let's Encrypt -> Request Certificate

Updates: The system default is to auto update weekly. You can change this in the Virtualmin admin panel.

You now have a WikiSuite server. Congrats!

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

You will get kicked out. Reconnect after reboot.
sudo reboot


Next steps:

  1. Create a Virtual Server for your Tiki, based on a plan
  2. Use Tiki Manager to install Tiki Wiki CMS Groupware

Create a Virtual Server for your Tiki

Go to Ex: https://example.org:10000
Virtualmin > Create Virtual Server
For more info: https://www.virtualmin.com/documentation/tutorial/virtual-server-basics
Fill in the appropriate fields and make sure you check the "Tiki Manager" feature! Then click the "Create Server" button and you are done

Image

If a domain name is valid, free SSL (for https://) certificates from Let's Encrypt are automatically created. If you'll add the domain later, you can get SSL later: Virtualmin -> Select base domain -> Server Configuration -> SSL Certificate -> Let's Encrypt -> Request Certificate

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

Virtualmin has many other features like domain alias, domain rename, etc. which we invite you to discover.

Installing Tiki via the included Tiki Manager feature

For more info, please see Tiki Manager docs.

To access everything related to our manager you have to navigate to Services > Tiki Manager.

Just fill in the email address, note the password, choose the desired Tiki Version and hit install. The Tiki Manager will inform you that your instance is ready; you can visit it at your Virtual server URL and manage it using the username "admin" and your previously displayed password.

Image

You now also have a Tiki instance running on your WikiSuite server

Enjoy discovering, configuring and using your Tiki!

The Tiki Admin Dashboard looks like this:
11

Extras

There are Alternative ways to automatically install Tiki

Force all traffic to SSL / HTTPS

Email

Find out more, ask the community for help and get involved via the official website Tiki Wiki CMS Groupware

History

Advanced
Information Version
Marc Laporte Tiki25 will take most of the energy for a while 263
View
Marc Laporte CentOS 8.x is soon EoL 262
View
Marc Laporte I just tested with Debian 9 261
View
Marc Laporte sudo is not always installed 260
View
Horia N. 259
View
Horia N. 258
View
Horia N. 257
View
Horia N. 256
View
Marc Laporte 255
View
Horia N. 254
View
Horia N. 253
View
Horia N. 252
View
Horia N. 251
View
Horia N. 250
View
Horia N. 249
View
Horia N. 248
View
Horia N. 247
View
Horia N. 246
View
Marc Laporte 245
View
Marc Laporte 244
View
Marc Laporte More hiding 243
View
Marc Laporte 242
View
Horia N. 241
View
Marc Laporte 240
View
Marc Laporte redundant 239
View
Marc Laporte 238
View
Marc Laporte 237
View
Horia N. 236
View
Horia N. 235
View
Horia N. 234
View
Horia N. 233
View
Horia N. 232
View
Horia N. 231
View
Horia N. 230
View
Horia N. 229
View
Horia N. 228
View
Horia N. 227
View
Horia N. 226
View
Horia N. 225
View
Horia N. 224
View
Horia N. 223
View
Horia N. 222
View
Marc Laporte 221
View
Marc Laporte 220
View
TSHITENG BENITO 219
View
Marc Laporte 218
View
Marc Laporte 217
View
Marc Laporte 216
View
Marc Laporte 215
View
Marc Laporte Use sudo to make it simpler for less experienced admins 214
View