Split your transactions with teiler.io.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
gradle
src
.dockerignore
.gitignore
.travis.yml
CONTRIBUTING.md
Dockerfile
LICENSE
README.md
application.properties-example
build.gradle
checkstyle.xml
docker-compose.yml
gradlew
gradlew.bat
sonar-project.properties
tylr-eclipse.xml
tylr-intellij.xml

README.md

Teiler

Codacy Badge Codacy Badge

Teiler is a REST API to help you to split up expenses in groups.

Run with docker

Prerequisites:

  • Docker
  1. Clone the master branch or a version tag from Github.
  2. Run docker-compose up -d teiler to run the server.

Run from precompiled binaries

Prerequisites:

  • Java / OpenJDK 8
  • PostgreSQL 9
  1. Install the prerequisites.
  2. Download the newest release from Github.
  3. Run the following commands to create a user and database:
CREATE USER tylr IDENTIFIED BY 'tylr';
CREATE DATABASE tylr WITH OWNER tylr ENCODING 'UTF8' LC_COLLATE = 'en_US.UTF-8' LC_CTYPE = 'en_US.UTF-8'
GRANT ALL PRIVILEGES ON DATABASE tylr to tylr;
psql -f sql/create_tables.sql tylr tylr
  1. Create theapplications.properties file and add the database credentials.
# Datasource settings
spring.datasource.url = jdbc:postgresql://localhost:5432/tylr
spring.datasource.username = tylr
spring.datasource.password = tylr
#server.port = 4567 #default
#server.ip = 127.0.0.1 #default
  1. Run scripts/tylr-api to start the server.
  2. Access it through http://localhost:PORT

If you want to access the API from outside localhost or / and SSL, use a reverse proxy in front of the application like an NGINX.

Run from source

Prerequisites:

  • Java / OpenJDK 8
  • PostgreSQL 9
  1. Install the prerequisites.
  2. Clone the master branch or a version tag from Github.
  3. Do steps 4 and 5 from above.
  4. Run ./gradlew run to run the server.

Architecture

This project is the backend implementation for teiler. It implements the API specification created at doc.teiler.io.

Clients

Everyone is invited to create their own clients. Here's a list of clients we know of:

Contributing

For contribution guidelines and software architectural help, see CONTRIBUTING