Alf.io logo

Alf.io

  •  0 ratings
In category: Booking and Scheduling

About Alf.io

The open source ticket reservation system.

  •   1372  
  •   0  
  •   0  
  •   0  
Github stats:
  •  Commits: 3,647  
  •   11,000  
  •   289  
  •  Latest commit: Feb 12, 2023  

Deploy this app to Linode with a free $100 credit!

Languages/Platforms/Technologies:
Lincenses:

More about Alf.io

alf.io

The open source ticket reservation system.

Alf.io is a free and open source event attendance management system, developed for event organizers who care about privacy, security and fair pricing policy for their customers.

Build Status Security Rating Reliability Rating Coverage

Financial Contributors on Open Collective Docker Hub Pulls Open Source Helpers

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 2.0-M4-maintenance branch, as it contains production-ready code.

Prerequisites

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

Postgresql version 10 or later.

Additionally, the database user that creates and uses 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 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 10 or later) instance up and running on localhost:5432
  • a postgres user having a password: password
  • a database named alfio

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

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.

Notes: - this project uses Project Lombok. You will need to install the corresponding Lombok plugin for integration into your IDE. - this project uses TestContainers to run integration tests against a real PostgreSQL database. Please make sure that your configuration meets their requirements

How to configure TestContainers with Podman (Fedora 34)

As TestContainers expect the docker socket for managing the containers, you will need to do the following (see original issue for details): Define the 2 env. variable:

export TESTCONTAINERS_RYUK_DISABLED=true
export DOCKER_HOST=unix:///run/user/1000/podman/podman.sock
And run in another console:
podman system service -t 0
To be noted: - for unknown reason, the first time podman download the missing images, testcontainers will fail. Run another time and it will work. - in theory, with systemd+socket activation the service should start automatically, but currently I was not able to make it works.

Check dependencies to update

./gradlew dependencyUpdates

Docker

Container images are available on https://hub.docker.com/r/alfio/alf.io/tags.

alf.io can also be run with Docker Compose (experimental):

docker-compose up

Running alf.io in production using Docker compose is not officially supported. However, if you decide to do so, 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
Alternatively, you can use Docker (experimental):
docker run --rm -u gradle -v "$PWD":/home/gradle/project -w /home/gradle/project gradle:7.0.0-jdk11 gradle --no-daemon distribution -x test

Please note that at the moment the command above performs the build without running the automated tests. Use it at your own risk.

Create docker image:

docker build -t alfio/alf.io ./build/dockerize

About the included AppleWWDRCAG4.cer

The certificate at src/main/resources/alfio/certificates/AppleWWDRCAG4.cer has been imported for https://github.com/ryantenney/passkit4j#usage functionality. It will expire the 2030-10-12 (YYYY-MM-DD - as of 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

Contributors

Code Contributors

This project exists thanks to all the people who contribute.

Translation Contributors (POEditor)

A big "Thank you" goes also to our translators, who help us on POEditor:

(we show the complete name/profile only if we have received explicit consent to do so)

Language Name Github Twitter
Dutch (nl) Matthjis
Turkish (tr) Dilek
Spanish (es) Mario Varona @mvarona @MarioVarona
Spanish (es) Sergi Almar @salmar @sergialmar
Spanish (es) Jeremias
Bulgarian (bg) Martin Zhekov @Martin03 @MartensZone
Portuguese (pt) Hugo
Swedish (sv) Johan
Romanian (ro) Daniel
Polish (pl) Pawel
Danish (da) Sune

translations completed but not yet integrated (WIP)

Language Name Github Twitter
Japanese (jp) Martin
Chinese (Taiwan) (cn_TW) Yu-cheng, Lin

Sponsors

This project is sponsored by:

Swicket
Powered by BrowserStack Open Source program

Exteso   Starplane   Amici del Ticino   Netlify

Financial Contributors

Become a financial contributor and help us sustain our community. [Contribute]

Individuals

Organizations

Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]

   

Comments (0)

Please login to join the discussion on this project.

Alf.io Reviews (0)

Overall Rating

None

based on 0 ratings

Please login to review this project.

No reviews for this project yet.

↑ back to top

Linux VPS from $11/yr.
RackNerd VPS for $11.38/mo

Popular Projects

FluxBB

in Social Networks and Forums
 29k    0    0    0  

Nextcloud

in File Transfer & Synchronization
 17k    1    1    0  

Libreddit

in Social Networks and Forums
 4k    0    1    0  

CasaOS

in Self-hosting Solutions
 4k    0    0    0  

Audiobookshelf

in Audio Streaming
 3k    0    1    0  

Mediagoblin

in Photo and Video Galleries
 3k    0    0    0  

Dashboard

in Personal Dashboards
 2k    0    0    0  

Most Discussed

Nextcloud

in File Transfer & Synchronization
 17k    1    1    0  

Tube Archivist

in Automation
 2k    0    1    0  

OneDev

in Project Management
 1k    0    0    0  

iodine

in Proxy
 1k    0    0    0  

Alf.io

in Booking and Scheduling
 1k    0    0    0  

sysPass

in Password Managers
 711    0    0    0  

Misskey

in Social Networks and Forums
 2k    0    0    0  
pCloud Lifetime

Top Rated Projects

Gitea

 1 rating
in Project Management

Bagisto

 1 rating
in E-commerce

LinkAce

 1 rating
in Bookmarks and Link Sharing

Pydio

 1 rating
in File Transfer & Synchronization

Audiobookshelf

 1 rating
in Audio Streaming

Nextcloud

 1 rating
in File Transfer & Synchronization

Seafile

 1 rating
in File Transfer & Synchronization

Categories

You May Also Be Interested In

Cal.com logo
Cal.com cover

Cal.com

The open-source online appointment scheduling system.

Easy!Appointments logo
Easy!Appointments cover

Easy!Appointments

A highly customizable web application that allows your cust…

QloApps logo
QloApps cover

QloApps

Free open source hotel reservation & online booking system