alextselegidis/timecrack repository overview

⁠
⁠
Timecrack Docker

⁠ A powerful Open Source Time Tracking application that can be installed on your server.

About⁠ • Features⁠ • Setup⁠ • Environment Variables⁠ • License⁠

⁠About

Timecrack is a time tracking application, designed for simplicity and efficiency. It lets you define your projects and tasks, and then track the time you spend on them. You can also add notes to your time entries, and view reports of your time usage.

This Docker image is built on PHP 8.2 with Apache and is designed to run the Laravel-based Timecrack application. On container startup, the entrypoint script automatically generates the Laravel .env file from Docker environment variables, runs database migrations, and caches the configuration for optimal performance.

⁠Features

The application allows you to manage and organize your time trackings.

• Clean & minimal interface
• Tagging & search
• Self-hosted (Docker support)
• Multi-user capable (future/planned)
• No tracking / no ads

⁠Setup

To clone and run this application, you'll need Docker⁠ installed on your computer. From your command line:

# Start a MySQL instance
docker run -d --name timecrack-db \
  -e MYSQL_ROOT_PASSWORD=secret \
  -e MYSQL_DATABASE=timecrack \
  mysql:8.0

# Pull and run the app
docker run -d --name timecrack-app \
  --link timecrack-db:db \
  -p 80:80 \
  -e APP_URL=http://localhost \
  -e DB_HOST=db \
  -e DB_DATABASE=timecrack \
  -e DB_USERNAME=root \
  -e DB_PASSWORD=secret \
  alextselegidis/timecrack:latest

⁠Docker Compose

You can use the following docker-compose.yml file to locally set up Timecrack with a MySQL database:

services:

  timecrack:
    image: alextselegidis/timecrack:latest
    restart: always
    ports:
      - '80:80'
    environment:
      - APP_NAME=Timecrack
      - APP_ENV=production
      - APP_DEBUG=false
      - APP_URL=http://localhost
      - DB_CONNECTION=mysql
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_DATABASE=timecrack
      - DB_USERNAME=root
      - DB_PASSWORD=secret
      - MAIL_MAILER=smtp
      - MAIL_HOST=smtp.example.org
      - MAIL_PORT=587
      - MAIL_USERNAME=
      - MAIL_PASSWORD=
      - MAIL_ENCRYPTION=tls
      - [email protected]
      - MAIL_FROM_NAME=Timecrack
    volumes:
      - timecrack-storage:/var/www/html/storage

  mysql:
    image: mysql:8.0
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=secret
      - MYSQL_DATABASE=timecrack
    volumes:
      - mysql:/var/lib/mysql

volumes:
  timecrack-storage:
  mysql:

⁠Environment Variables

The Docker image uses standard Laravel environment variables. All variables are passed through to the .env file that is generated on container startup.

⁠Application

⁠Logging

⁠Database

⁠Cache & Session

⁠Redis

⁠Mail

⁠Startup Behavior

On every container start the entrypoint script will:

1. Generate the Laravel .env file from the Docker environment variables.
2. Set correct permissions on storage/ and bootstrap/cache/.
3. Auto-generate an APP_KEY if one was not provided.
4. Run php artisan migrate --force to apply pending database migrations.
5. Create the storage:link symbolic link.
6. Cache configuration, routes, and views for performance.
7. Start the Apache web server.

⁠License

Code Licensed Under GPL v3.0⁠ | Content Under CC BY 3.0⁠

Website alextselegidis.com⁠  ·  GitHub alextselegidis⁠  ·  Twitter @alextselegidis⁠