Skip to content
alf.io - The open source ticket reservation system
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Update issue templates May 12, 2018
clevercloud
config Added gradle support. Jan 29, 2015
etc Migrate source code to JDK11 (#572) Dec 29, 2018
gradle/wrapper
src check if account number is present before referencing it Apr 19, 2019
.bowerrc issue #1 - init components Aug 19, 2014
.editorconfig fix editorconfig file Nov 23, 2018
.gitignore add .gradletasknamecache to .gitignore (#601) Feb 7, 2019
.travis.yml travis: test multiple postgresql versions (#592) Jan 28, 2019
CHANGELOG.md
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Jun 17, 2017
LICENSE Initial commit Jul 26, 2014
README.md add minor clarification to README (re. 8080 & admin) (#600) Feb 7, 2019
azure-pipelines.yml Migrate source code to JDK11 (#572) Dec 29, 2018
build.gradle #455 - add an option to configure the ID to use in public references … Apr 9, 2019
custom.jvmargs.example
docker-compose.yml Docker: remove dependence on links feature (#589) Jan 23, 2019
gradle.properties update deps Mar 10, 2019
gradlew #476 import billing document (#563) Dec 17, 2018
gradlew.bat
lib_exclude collect additional info only for selected categories, if any Jun 14, 2018
lombok.config #383 re-add previous lombok behaviour Feb 5, 2018
settings.gradle Added gradle support. Jan 29, 2015

README.md

alf.io

alf.io

Build Status Coverage Status

Warning

As the work for Alf.io v2 has started, this branch may contain unstable and untested code. If you want to build and deploy alf.io by yourself, we strongly suggest you to use the 1.x-maintenance branch.

Prerequisites

You should have installed Java version 11 (e.g. Oracle's, OpenJDK, or any other distribution) in order to build and run alf.io. Please note that for the build process the JDK is required.

Postgresql version 9.6 or later.

Additionally, the database user that create and use the tables should not be a "SUPERUSER", or else the row security policy checks will not be applied.

Run on your machine

Gradle Build

This build includes a copy of the Gradle wrapper. You don't have to have Gradle installed on your system in order to build the project. Simply execute the wrapper along with the appropriate task, for example

./gradlew clean

Running with multiple profiles

You must specify a project property at the command line, such as

./gradlew -Pprofile=dev :bootRun

The local "bootRun" task has the following prerequisites:

  • a PostgreSQL (version 9.6 or later) instance up and runnning on localhost:5432
  • a postgres user having password: password
  • a database named alfio

once started, alf.io will create all the required tables on the database, and be available at http://localhost:8080/admin. You can login using the default Username admin and the password which was printed on the console.

Note: if you want to test without installing a pgsql instance, we have configured the following tasks:

  • startEmbeddedPgSQL
  • stopEmbeddedPgSQL

So, in a terminal first launch pgsql:

./gradlew startEmbeddedPgSQL

In another one launch alf.io

./gradlew -Pprofile=dev :bootRun

When you are done, kill the pgsql instance with:

./gradlew stopEmbeddedPgSQL

The following profiles are supported

  • dev
  • dev-pgsql
  • docker-test

You can get a list of all supported Gradle tasks by running

./gradlew tasks --all

You can configure additional System properties (if you need them) by creating the following file and putting into it one property per line:

vi custom.jvmargs

Please be aware that since this file could contain sensitive information (such as Google Maps private API key) it will be automatically ignored by git.

For debug

Add a new line with: -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 in custom.jvmargs

Developing alf.io

Importing the Gradle project into Intellij and Eclipse both work.

Note: this project uses Project Lombok. You will need to install the corresponding Lombok plugin for integration into your IDE.

Check dependencies to update

./gradlew dependencyUpdates

Docker

alf.io can be run for development with Docker Compose:

docker-compose up

If you plan on using Docker Compose to run alf.io in production, then you need to make a couple of changes:

  • Add a mapping for port 8443
  • Handle SSL termination (e.g. with something like tutum/haproxy)
  • Remove the SPRING_PROFILES_ACTIVE: dev environment variable

Test alf.io application

  • Check alfio logs: docker logs alfio
  • Copy admin password in a secure place
  • Get IP of your docker container: (only on Mac/Windows, on linux the proxy will bind directly on your public IP)
    • boot2docker ip on Mac/Windows
  • Open browser at: https://DOCKER_IP/admin
  • Insert user admin and the password you just copied

Generate a new version of the alfio/alf.io docker image

  • Build application and Dockerfile:
./gradlew distribution
  • Enter the directory:
cd build/dockerize
  • Create docker image:
docker build -t alfio/alf.io .

About the included AppleWWDRCA.cer

The certificate at src/main/resources/alfio/certificates/AppleWWDRCA.cer has been imported for https://github.com/ryantenney/passkit4j#usage functionality. It will expire the 02/07/23 (as https://www.apple.com/certificateauthority/).

Available spring profiles:

  • dev: enable dev mode
  • spring-boot: added when launched by spring-boot
  • demo: enable demo mode, the accounts for the admin will be created on the fly
  • disable-jobs: disable jobs
You can’t perform that action at this time.