Copyright © Andrew Ying and other contributors 2016-2019.

Installing

Requirements

If you're not using the Docker image, you will need to make sure that the following are installed on your machine:

• Web server (e.g. Apache or Nginx)
• PHP, version 7.1 or above
• Database (either MySQL or MariaDB)
• Node.js and npm

Steps

• Clone repository and install dependencies

git clone https://github.com/JanoCodes/Ticketing.git
cd Ticketing
composer install --no-dev
npm install

• Stylesheet can be customised by editing resources/assets/sass/_variables.scss
• Complie stylesheet and scripts

npm run production

• Edit the configuration file at .env and storage/settings.hjson
• Generate the public and private keys for OAuth authentication

openssl genpkey -algorithm RSA -out storage/oauth-private.key -pkeyopt rsa_keygen_bits:2048
openssl rsa -in storage/oauth-private.key -outform PEM -pubout -out storage/oauth-public.key

• Create tables required by the application

php jano migrate

• Point web server to public directory and you're done!

If you do not want to have to worry about the dependencies, you can also use the Docker image janorocks/ticketing.

Contributing

Jano Ticketing System is open source and relies on the help of the community to maintain. You are welcomed to work at issues and submit pull requests. Please note our Contributing Guide and our Contributor Code of Conduct.

Localisation

We want to make Jano Ticketing System accessible to everyone, no matter where you live, or which language you speak. Give us a hand in helping us translate the program at Crowdin!

License

Jano Ticketing System is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License v3.0 supplemented by additional permissions and terms.

Jano Ticketing System is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

Credits

The Jano Ticketing System is not possible without the presence of numerous other projects and the generosity of the sponsors below.

Server Hosting	Global CDN
Single Sign-On	Browser compatibility testing
Application monitoring

• License management by FOSSA