Quiqqer Setup Guide
1) Console Setup
If you do have ssh access to your server you can easily install Quiqqer via the console.
Preparations
Connect to your server and prepare your webserver for Quiqqer
If you do not know how to set up a vhost, you can follow these guides
- Quiqqer : Nginx config
- Quiqqer: Apache config (not available yet)
Setup process
Change to your directory root
cd /var/www/vhosts/domain.tld
Download the current setup archive
wget -O quiqqer.zip https://update.quiqqer.com/quiqqer.zip
Hint : -O quiqqer.zip: renames the downloaded file to quiqqer.zip
Unzip the setup archive:
unzip quiqqer.zip
Almost done!
Execute the setup.php file and follow the instructions
php setup.php
Shortcut
If you know what you are doing you can use this shortcut after you have changed to your desired installation location
wget -O quiqqer.zip https://update.quiqqer.com/quiqqer.zip && unzip quiqqer.zip && php setup.php
Presets
The Setup allows you to provide a "preset".
Presets are initial settings, which should be applied to the installed system.
Presets can contain the following settings:
- Project name and its languages
- Template for the project
- Custom repositories, which should be added to the composer.json
- Packages, which should be installed
To create a preset you have to create a json file with the name of your preset.
The file has to be located in the directory /templates/presets.
For example : setup/templates/presets/passwordmanager.json
The format of the json-object is the following :
{ "project": { "name": "Mainproject", "languages": [ "de", "en" ] }, "template": { "name": "quiqqer/template-helios", "version": "dev-master", "start_layout": "layout/startpage", "default_layout": "layout/startpage" }, "repositories": [ { "type": "vcs", "url": "git@dev.quiqqer.com:quiqqer/gitlab.git" } ], "packages": { "quiqqer/gitlab": "dev-dev" } }
FAQ
Q : Can I verify, that the quiqqer.zip was downloaded correctly?
A : Absolutely!
You can find a MD5-Checksum of the current quiqqer.zip under : https://update.quiqqer.com/checksum.md5
You can get the MD5-Checksum of your downloaded file by running md5sum quiqqer.zip
in your console.