README.md

OpenSB Orange

How to setup an OpenSB instance.

1. Get an Apache server with PHP and MariaDB up and running, including Composer and the PHP GD library extension. NGINX/FreeNGINX should work, but we use Apache on Qobo production.
2. Setup a virtual host. Look below the steps for an example.
3. Run composer update from the terminal.
4. Copy config.sample.php, rename it to config.php and fill in your database credentials.
5. Import the database template found in sql/ into the database you want to use.
6. Run the compile-scss script available in the tools directory to generate the required stylesheets. You may find Dart-Sass here at https://sass-lang.com/install/.

Production specific

1. Instead of installing dependencies using composer update you do composer update --no-dev
2. Make the dynamic/ and templates/cache/ directories writable by your web server.
3. Modify $branding to replace openSB branding with your custom branding. Check the public/assets/placeholder directory for reference.

Development specific

1. Disable Twig's template caching by setting $tplNoCache to true.
2. Enable debugging features by setting $isDebug to true.
3. If you want to be able to upload during development, make the dynamic/ directory and the directories inside it writable by your web server.

Virtual host example

You will have to modify the directories to match your instance's location.

<VirtualHost *> 
    ServerName localhost
    DocumentRoot "C:/xampp/openSB/public"

    Alias /dynamic "C:/xampp/openSB/dynamic"

    <Directory "C:/xampp/openSB">
        Options Indexes FollowSymLinks
        Require all granted
        AllowOverride All
    </Directory>
</VirtualHost>

Questions

Why do I get 404 errors when I click on thumbnails?

Assuming you use Apache and have the rewrite module installed, this is because AllowOverride is turned off. See the virtual host example above for a quick fix.

Is this related to Kylarz's squareBracket?

No. Kylarz's squareBracket uses a closed-source "TicTac" backend and is not affiliated with us. The original squareBracket (by Bluffingo) was renamed to Qobo in the latter half of 2022, and still uses OpenSB.