shinau/candycbt repository overview

⁠CandyCBT OpenLiteSpeed Docker Container

Install a lightweight CandyCBT container with OpenLiteSpeed Edge or Stable version based on Ubuntu 22.04 Linux.

⁠Prerequisites

1. Install Docker⁠
2. Install Docker Compose⁠

⁠Configuration

Edit the .env file to update the demo site domain, default MySQL user, and password. Feel free to check Docker hub Tag page⁠ if you want to update default CandyCBT.

⁠Installation

Clone this repository or copy the files from this repository into a new folder:

git clone https://github.com/shinau21/candycbt.git

Open a terminal, cd to the folder in which docker compose.yml is saved, and run:

docker compose up

⁠Single Installation

Run this command for single build CandyCBT

1. Pull Images

docker pull shinau/candycbt:latest

1. Run Container

• Notes:
• Port 7080 is OLS Admin
• Port 8080 is PhpMyAdmin

docker run -d --name candycbt -p 80:80 -p 443:443 -p 7080:7080 -p 8080:8080 shinau/candycbt

⁠Components

The docker image installs the following packages on your system:

⁠Data Structure

Cloned project

├── acme
├── bin
│   └── container
├── data
│   └── db
├── logs
│   ├── access.log
│   ├── error.log
│   ├── lsrestart.log
│   └── stderr.log
├── lsws
│   ├── admin-conf
│   └── conf
├── sites
│   └── localhost
├── LICENSE
├── README.md
└── docker-compose.yml

• acme contains all applied certificates from Lets Encrypt

• bin contains multiple CLI scripts to allow you add or delete virtual hosts, install applications, upgrade, etc

• data stores the MySQL database

• logs contains all of the web server logs and virtual host access logs

• lsws contains all web server configuration files

• sites contains the document roots (the CandyCBT application will install here)

⁠Usage

⁠Setup Environment File

1. Setup Environment File to configure CandyCBT Database Example:

TimeZone=Asia/Jakarta
OLS_VERSION=1.7.16
PHP_VERSION=lsphp74
MYSQL_DATABASE=database
MYSQL_ROOT_PASSWORD=password
MYSQL_USER=user
MYSQL_PASSWORD=password
DOMAIN=localhost

⁠Setup Database

1. Setup your Database on sites/localhost/html/config/config.database.php

$user = 'USERNAME';
$pass = 'PASSWORD';
$debe = 'DATABASE';

Same as you define in env file

⁠Starting a Container

Start the container with the up or start methods:

docker compose up

You can run with daemon mode, like so:

docker compose up -d

The container is now built and running.

⁠Stopping a Container

docker compose stop

⁠Removing Containers

To stop and remove all containers, use the down command:

docker compose down

⁠Setting the WebAdmin Password

We strongly recommend you set your personal password right away.

bash bin/webadmin.sh my_password

⁠Update Web Server

To upgrade the web server to latest stable version, run the following:

bash bin/webadmin.sh [-U, --upgrade]

⁠Apply OWASP ModSecurity

Enable OWASP mod_secure on the web server:

bash bin/webadmin.sh [-M, --mod-secure] enable

Disable OWASP mod_secure on the web server:

bash bin/webadmin.sh [-M, --mod-secure] disable

⁠Accessing the Database

After installation, you can use phpMyAdmin to access the database by visiting http://127.0.0.1:8080 or https://127.0.0.1:8443. The default username is root, and the password is the same as the one you supplied in the .env file.

1. Build and start it with command:

docker compose up --build