Installation


Wie bringe ich VoteEasy für mich zum Laufen?

Technologiestack

Als Administrator sollte man sich mit den folgenden Technologien auskennen, um VoteEasy installieren und betreiben zu können:

  • Programmiersprache: Java 17
  • Framework: SpringBoot Version 3
  • Datenbank: PostgreSQL (andere sind aber möglich und konfigurierbar)
  • Frontend: HTML5, CSS3, JavaScript, Bootstrap 5.3.2
  • Build-Tool: Maven
  • Containerisierung: Docker

Lizenzbedingungen

Die Anwendung selbst ist unter der Lizenz AGPL v3.0 verfügbar und kann lokal installiert werden. Änderungen am Quellcode sind möglich und können in der eigenen Installation vorgenommen werden. Weiterentwicklung und umfangreichere Anpassungen sind möglich, solange die Lizenzbedingungen eingehalten werden.

Installationshinweise

Ausprobieren in 3 Schritten

Unter der Annahme, dass Java, Maven und Docker bereits installiert sind, kann VoteEasy mit den folgenden Befehlen gestartet werden:

$ git clone https://github.com/voteeasy/webapp.git
$ cd webapp
$ ./sh/cleanUpDBAndStartDocker.sh

Die Anwendung ist dann in der Standardkonfiguration unter http://localhost:8080 aufrufbar.

Beispielkonfiguration

Standardmäßig gibt es in VoteEasy zwei Organisationen, die mit Beispieldaten gefüllt sind:

  • Partei
  • Gartenverein

Jede der Organisationen hat drei Nutzer:

  • Teilnehmer 1: emil mit Passwort: emil
  • Teilnehmer 2: sandman mit Passwort: sandman
  • Administrator: gongbing mit Passwort: gongbing

Nach erfolgtem Login sollten die Passwörter aus Sicherheitsgründen geändert werden.

Was sollte man ändern?

Aus Sicherheitsgründen sollte mit Hilfe des Instanzadministratorkontos unverzüglich das Passwort verändert werden. Die initialen Zugangsdaten lauten:

  • VoteEasy-Organisation: voteeasy
  • VoteEasy-Superadmin: gongbing
  • VoteEasy-Superadmin-Passwort: gongbing

Nur der Superadmin kann auch obige Beispielorganisationen entfernen, um die Anwendung für die eigene Umgebung anzupassen.

Es ist jederzeit möglich, weitere Organisationen anzulegen!

Individuelle Unterstützung und Anfragen

VoteEasy ist ein einfaches Abstimmungstool, das als freie Software zur Verfügung steht.

Bei technischen oder inhaltlichen Anfragen besteht die Möglichkeit, sich individuell zu melden. Ein kostenpflichtiger Support ist vereinbar und grundsätzlich möglich.

Wir finden einen Weg.

Table of Contents
Last modified on 2026-11-21

Handmade with ❤️ in Germany -