Sign inSign up

relapps/ptrac

By relapps

•Updated over 1 year ago

Free Project Time Tracking Software

Image
1

1.5K

relapps/ptrac repository overview

⁠Free Project Time Tracking Software

Some of the features

  • Self-hosted web application
  • The application runs in a Servlet Container such as Tomcat or standalone
  • Data is stored in a relational database (MariaDB, MySQL or Postgresql)
  • Definition of users and groups
  • User authentication with LDAP
  • Roles and groups to control the permissions
  • Hierarchical definition of projects
  • Work-calendar definition with holidays and work hours
  • Register of time worked (start and end time)
  • Private individual rich-text (markup) diary
  • Printing of time-sheets (timecard) with annotations
  • Reports (Excel and Open Document Format ODF)
  • Export and import between databases
  • Web service API (example Java and Python applications⁠)
  • Free of charge (no ads)

See https://relapps.net⁠ for more information.

The docker image include Alpine Linux, OpenJDK, Spring framework and other software.

The port 8080 is used to offer the service.

Example docker compose file using MariaDB:

version: '3.2'
#
# Example Docker compose file for ptrac and mariadb.
#
# Available environment variables for ptrac:
#  - PTRAC_DB_TYPE (database type mariadb, mysql or postgres)
#  - PTRAC_DB_HOST (database host)
#  - PTRAC_DB_NAME (database name)
#  - PTRAC_DB_USER (database user)
#  - PTRAC_DB_PASSWORD (database user password)
#  - PTRAC_DB_PORT (optional: database port)
#
# Specify entrypoint with the path if you need to run the application in a different context.
# entrypoint: ["/scripts/run.sh", "--server.servlet.context-path=/ptrac"]
#
services:
    ptrac_app:
        container_name: ptrac_app
        image: relapps/ptrac:latest
        restart: always
        depends_on:
            - ptrac_db
        ports:
            - 8080:8080
        environment:
            PTRAC_DB_TYPE: mariadb
            PTRAC_DB_HOST: ptrac_db
            PTRAC_DB_NAME: ptrac
            PTRAC_DB_USER: ptrac
            PTRAC_DB_PASSWORD: ptrac
            PTRAC_DB_PORT: 3306
        volumes:
            - /home/user/ptrac/data:/data

    ptrac_db:
        container_name: ptrac_db
        image: mariadb:10.4
        restart: always
        environment:
            MYSQL_ROOT_PASSWORD: ptrac
            MYSQL_DATABASE: ptrac
            MYSQL_USER: ptrac
            MYSQL_PASSWORD: ptrac
        volumes:
            - /home/user/ptrac/db:/var/lib/mysql

Example docker compose file using PostgreSQL:

version: '3.2'
#
# Example Docker compose file for ptrac and postgresql.
#
# Available environment variables:
#  - PTRAC_DB_TYPE (database type mariadb, mysql or postgres)
#  - PTRAC_DB_HOST (database host)
#  - PTRAC_DB_NAME (database name)
#  - PTRAC_DB_USER (database user)
#  - PTRAC_DB_PASSWORD (database user password)
#  - PTRAC_DB_PORT (optional: database port)
#
# Specify entrypoint with the path if you need to run the application in a different context.
# entrypoint: ["/scripts/run.sh", "--server.servlet.context-path=/ptrac"]
#
services:
    ptrac_postgres_app:
        container_name: ptrac_postgres_app
        image: relapps/ptrac:latest
        restart: always
        depends_on:
            - ptrac_postgres_db
        ports:
            - 8080:8080
        environment:
            PTRAC_DB_TYPE: postgres
            PTRAC_DB_HOST: ptrac_postgres_db
            PTRAC_DB_NAME: ptrac
            PTRAC_DB_USER: ptrac
            PTRAC_DB_PASSWORD: ptrac
        volumes:
            - /home/user/ptrac/data:/data

    ptrac_postgres_db:
        container_name: ptrac_postgres_db
        image: postgres:13
        restart: always
        environment:
            - POSTGRES_USER=ptrac
            - POSTGRES_PASSWORD=ptrac
        logging:
            options:
                max-size: 10m
                max-file: "3"
        volumes:
            - /home/user/ptrac/db:/var/lib/postgresql/data

Start the containers with docker-compose:

docker-compose -f ptrac-compose.yml up -d

Tag summary

Content type

Image

Digest

sha256:9eaf7953e…

Size

215.4 MB

Last updated

over 1 year ago

docker pull relapps/ptrac