Documentation

Setup

Download

Via Composer/Packagist

composer create-project offmania9/boostack
Import as vendor: composer require offmania9/boostack

Installation

You can install Boostack using two distinct installation procedures:
  • [recommended] via Docker which will install 3 containers (php-apache, maria db, phpmyadmin) including all the requirements necessary for the operation of Boostack. Jump to Docker Installation chapter.
  • or as a stand-alone application within an Apache web application server
    General requirements
    • PHP >= 7.4
    • PDO PHP Extension
    Apache modules enabled (httpd.conf):
    • mod_rewrite
    • mod_headers
    • mod_filters

    Virtual host configuration:

        <Directory /var/www/html>
            Options FollowSymLinks MultiViews
            AllowOverride All
            Order allow,deny
            allow from all
        </Directory>
    Optimal Server Configuration
    HTTP Strict Transport Security (HSTS) is an opt-in security enhancement that is specified by a web application through the use of a special response header. Once a supported browser receives this header that browser will prevent any communications from being sent over HTTP to the specified domain and will instead send all communications over HTTPS. It also prevents HTTPS click through prompts on browsers.

Docker Installation

Before launching Boostack installation via Docker, make sure you have set the variables found in the .env file at the project root

    DB_HOST=db
    DB_PORT=3306
    DB_DATABASE=boostack_db
    DB_PASSWORD_ROOT=ROOT
    DB_USERNAME=boostack_usr
    DB_PASSWORD=boostack_pwd

Ok, now you're ready to run the "docker compose" command at the project root.

docker-compose up -d --build

In the Docker compose file, you need to comment out the user parameter for php-apache based on the operating system: 502:20 for macOS and 1000:1000 for Unix. Leave both lines commented out (disabled) in case of Windows operating systems.

php-apache:
# user: "502:20" #-> MacOS
# user: "1000:1000" #-> Unix

Jump to First Configuration →