kevinveenbirkenbach/computer-playbook
1
0
Fork 0
mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2024-09-20 00:13:09 +02:00
Code Issues Packages Projects Releases Wiki Activity
4d5aea8609
computer-playbook/roles/docker-mybb
History
Kevin Veen-Birkenbach 4d5aea8609 changed task structure
2023-12-08 18:22:28 +01:00
..
handlers Updated role 2023-12-05 22:17:47 +01:00
meta implemented cross-domain matomo tracking on nginx level 2023-11-18 20:02:55 +01:00
tasks changed task structure 2023-12-08 18:22:28 +01:00
templates Updated mybb README.md, renamed variables, solved mybb bug 2023-12-07 15:35:57 +01:00
vars changed task structure 2023-12-08 18:22:28 +01:00
README.md implemented multiple domain string substitution for mybb 2023-12-07 18:54:47 +01:00

README.md

Role Name: Docker MyBB

Dependencies

  • nginx-docker-reverse-proxy

Usage

Multi Domain Installation

If you want to access your mybb over multiple domains, keep the following in mind:

  • Set Cookie Domain to nothing
  • Access mybb for installation via mybb.<top_domain>
  • Set the Board Url to mybb.<top_domain>

Manual Installation of MyBB Plugins

This guide describes the process of manually installing MyBB plugins in your Docker-MyBB environment. This can be useful if you want to quickly test plugins or do not wish to execute the Ansible role.

Steps for Manual Installation

  1. Prepare Plugin Files:

    • Download the desired MyBB plugin zip files.

  2. Copy plugin to host:

    • bash scp <plugin> administrator@<server>:/home/administrator/docker-compose/mybb/plugins

  3. Unzip Plugin Files on the Host:

    • Unzip the plugin zip files in the host's plugin directory: 
      unzip /home/administrator/docker-compose/mybb/plugins/<plugin-file>.zip -d /home/administrator/docker-compose/mybb/plugins/
    • Replace <plugin-file>.zip with the name of the plugin zip file.
    • Repeat this step for each plugin.

  4. Access the Docker Container:

    • Open a terminal or SSH session on the server where the Docker container is running.

  5. Copy Unzipped Plugin Files to the Container:

    • Copy the unzipped plugin files from the host directory to the Docker container: 
      docker compose cp /home/administrator/docker-compose/mybb/plugins/<unzipped-plugin-folder> application:/var/www/html/inc/plugins/
    • Replace <unzipped-plugin-folder> with the name of the unzipped plugin folder.

  6. Restart the Container:

    • Execute the following command to restart the MyBB container: 
      docker-compose -p mybb up -d --force-recreate
    • This ensures all changes take effect.

  7. Activate Plugins in the MyBB Admin Panel:

    • Open the MyBB admin panel in your web browser.
    • Navigate to the plugin settings and activate the newly installed plugins.

Important Notes

  • Ensure you use the correct paths and filenames.
  • Do not forget to regularly back up your MyBB database and files before making changes.
  • If encountering issues, refer to the MyBB documentation or specific instructions from the plugin author.

Running the Role

Execute the Ansible playbook containing this role to set up MyBB in a Docker environment.

Docker Compose Configuration

The docker-compose.yml.j2 template outlines the services required for MyBB, including the application server, Nginx web server, and database (MariaDB).

Additional Information

  • For detailed configuration and customization, refer to the contents of the default.conf template and the docker-compose.yml.j2 template.
  • Ensure that the environment variables and paths are correctly set as per your system's configuration.

Created with ChatGPT

This README was created with the assistance of ChatGPT, based on a conversation held at this link. ChatGPT provided guidance on structuring this document and outlining the key components of the Docker MyBB role.

More Information