amazingcat/cattr repository overview

THIS SOURCE IS DEPRECATED, PLEASE USE https://git.amazingcat.net/groups/cattr/-/container_registries⁠

⁠What is Cattr?

Cattr is an open-source time tracking solution, designed to be flawlessly integrated with your infrastructure. Superpowered with features like built-in screenshot capture and activity detection, it's a great instrument to boost your team's performance straight to the top.

⁠Where report bugs and ask questions

Feel free to contact us via chat⁠

Or create tickets in our Gitlab⁠

⁠How to use that image

⁠Start an instance

Don't forget to replace placeholders with your variables.

docker run -d -it --restart always -p 80:80 -p 443:443 --name cattr \
  -e FRONTEND_DOMAIN="domain.loc" \
  -e ADMIN_MAIL="admin@localhost" \
  -e MAIL_FROM_ADDRESS="[email protected]" \
  -e FRONTEND_APP_URL="http://domain.loc" \
  amazingcat/cattr

⁠Add persisted storage

docker run -d -it --restart always -p 80:80 -p 443:443 --name cattr \
  -e FRONTEND_DOMAIN="domain.loc" \
  -e ADMIN_MAIL="admin@localhost" \
  -e MAIL_FROM_ADDRESS="[email protected]" \
  -e FRONTEND_APP_URL="http://domain.loc" \
  -v $PWD/cattr-db:/var/lib/mysql \
  -v $PWD/cattr-screenshots:/app/backend/storage/app/uploads/screenshots \
  -v $PWD/cattr-ssl:/etc/letsencrypt \
  -v $PWD/cattr-config:/app/backend/bootstrap/cache \
  amazingcat/cattr

⁠Add the first administrator to your Cattr instance

docker exec -it cattr sh -c "/app/install.sh $ADMIN_NAME $ADMIN_PASSWORD"

⁠Environment Variables

FRONTEND_DOMAIN

A domain that will use your Cattr instance

ADMIN_MAIL

Mail of the administrator. Will be used for the first log in and for registering an HTTPS cert

FRONTEND_APP_URL

Should be a full host, for example: http://some-domain.com

HTTPS optional

Boolean. Can be true or false. False by default. If true container will try to issue a cert via certbot

MAIL_FROM_ADDRESS optional

Mail address that container will use for outgoing messages