Every version is shipped with the same basic components:
- nginx
- PHP
- exif
- intl
- gd (incl. WebP support)
- imagick (using ImageMagick 7)
- pdo_mysql
- redis
- opcache
- MariaDB LTS
- 1 GB InnoDB Buffer Pool Size
- Dragonfly (redis)
Depending on the WSC version, the PHP version needs to be set in the .env
file:
Version | Min. PHP-Version | Max. PHP-Version |
---|---|---|
WoltLab Suite 6.1 | TBA | TBA |
WoltLab Suite 6.0 | PHP 8.1.2 | PHP 8.3.x |
WoltLab Suite 5.5 | PHP 7.4.21 | PHP 8.1.x |
WoltLab Suite 5.4 | PHP 7.2.24 | PHP 8.0.x |
WoltLab Suite 5.3 | PHP 7.0.22 | PHP 7.4.x |
WoltLab Suite 5.2 | PHP 7.0.22 | PHP 7.4.x |
WoltLab Suite 3.1 | PHP 5.5.4 | PHP 7.4.x |
WoltLab Suite 3.0 | PHP 5.5.4 | PHP 7.4.x |
The following instructions mainly refer to the installation via console. For Docker Desktop-specific instructions, please refer to the related manual.
Execute the following code to download the whole project:
git clone https://github.com/SoftCreatR/wsc-dockerized
cd wsc-dockerized
After checking out the desired WoltLab Suite Core version, it's time to set-up the container, but before proceeding, make sure to set-up the database credentials first. To do so, copy the file .env.example
to .env
, and edit the file. The options are self-explanatory. This step is optional, but it is recommended to perform it, especially if you want to use a specific WSC, or PHP version.
To start the container setup, execute this command:
docker-compose up
Depending on the host machine, this process may take a few minutes (especially on Windows, using Docker Desktop)
As soon as the container has been set-up successfully, you can install the WoltLab software itself. To do so, point your web browser to http://hostname-or-ip
(e.g. http://localhost
). You should now see something similar to this:
If this is the case: Congrats, you are nearly done. If not: Whoops. Something went wrong. Check your log files, and make sure, that you followed all steps until here. If nothing helps, file an issue.
Click on the "Start installation" button to proceed.
Since this project is primarily aimed at developers, you probably want to set up the software in developer mode. In this case, call the install.php
file with the parameter dev=1
, for example http://localhost/install.php?dev=1
.
During the installation, you might be asked for database information. It's important to know, that the database server is not reachable via localhost
, or 127.0.0.1
, but mysql
. It's also worth noting, that MySQL will be installed with a pre-created database, and pre-defined login information, if you didn't configure it during the container setup:
- Database name:
woltlab_suite
- Database user:
woltlab_suite
- Database password:
woltlab_suite
You may wonder, if this was already everything, and the simple answer is:
If no errors occurred during the installation process, everything is set-up, and you can enjoy using the WoltLab software ๐
Question: How can I use redis as caching method?
Answer:
- Log in to the administration panel of your WoltLab Suite Core installation (e.g.
http://localhost/acp
) - Head over to Configuration -> General -> Cache
- Check
Use Redis
underCaching Method
- Paste
redis:6379
into theRedis-Server
input field
Problem: redis doesn't seem to work after setting it up, it always shows "Filesystem" as cache source.
Solution: The given redis server ip is invalid. Make sure, not to use localhost
, or 127.0.0.1
. The correct hostname is redis
.
Problem:
An error has occurred while trying to connect to your database:
Connecting to MySQL server 'localhost' failed
SQLSTATE[HY000] [2002] No such file or directory
Solution: The given MySQL hostname is incorrect. Make sure, not to use localhost
, or 127.0.0.1
. The correct hostname is mysql
.
Problem:
An error has occurred while trying to connect to your database:
Connecting to MySQL server 'mysql' failed
SQLSTATE[HY000] [1045] Access denied for user '###'@'wsc_php-fpm_1.wsc_default' (using password: YES)
Solution: The given username, and/or password, and/or database name is incorrect. If you did not set-up custom database information, the correct information is:
- Database name:
woltlab_suite
- Database user:
woltlab_suite
- Database password:
woltlab_suite
If you have any ideas, just open an issue and describe what you would like to add/change.
If you'd like to contribute, please fork the repository and make changes as you'd like. Pull requests are warmly welcome.
This package is Treeware. If you use it in production, then we ask that you buy the world a tree to thank us for our work. By contributing to the ecologi project, youโll be creating employment for local families and restoring wildlife habitats.