View source for Install/1-0/PreRequisites

<div style="float:right;">
[[Install/2-0/ServerPackages|Next: 2.0 - Installing Software on the Server>>]]
</div>

= Installation Pre-Requisites =

Convention Master is a web application with a wide array of event-supporting functionality that can be configured by the user. The base web application will run on the incredibly common LAMP web server stack, but some of its additional functionalities require further configuration. Before you dive into the installation process, this page will show the resources you will require.

'''Note:''' While Convention Master is a relatively traditional LAMP application, that will run on many kinds of system, we simply do not have the manpower to support them all. If you wish to receive specific assistance with installation from the CM development team, we require you to utilise a Debian-based Linux web server. We recommend Ubuntu Server 22.04 LTS, and many of the commands and references in this guide will be tailored to that environment. If you wish to use another type of environment, you are free to do so, but be aware that you may need to adapt, ignore or replace some of the commands in this installation guide for your own circumstances.

== Base Application ==

{| class="wikitable"
|-
! '''Software''' !! '''Minimum Version''' !! '''Recomended Version''' !! '''Additional Notes'''
|-
| [https://httpd.apache.org/ Apache Web Server] || 2.0 ||   || Required modules: mod_rewrite, mod_php
|-
| [https://php.net/ PHP] || {{CM stable php requirement}} || 8.1 || Required modules: curl, gd, mysql, mbstring
|-
| [https://www.mysql.com/ MySQL] || {{CM stable mysql requirement}} || 8.0 || Testing underway for MySQL 8.0, no issues currently found
|-
| [https://ioncube.com Ioncube PHP Encoder] || N/A ||   || Available for any supported PHP version. Installation instructions can be found later in this guide.
|}

== Badge & Paper Printing ==

On Linux, you will require CUPS or EPL compatible printers, and the appropriate library installed.

If you have a Windows-only printer (many card printers are unfortunately so), we have a shell-script workaround that utilizes print-to-PDF.

Instructions on all these installation methods can be found later in this guide.

{| class="wikitable"
|-
! '''Printer Type''' !! '''Required Software''' !! '''Notes'''
|-
| CUPS || CUPS Printing System || 
|-
| EPL || Pkipplib || 
|}