# Loot

> Open-source, self-hosted web app to track community contributions and share their rewards through contributive budgets, with email notices and a read-only API.

- **Category:** [Collaboration](https://selfhost.directory/collaboration)
- **Licence:** agpl-3.0
- **Source model:** Open source
- **Latest version:** v2.1.0
- **Author:** loot-project
- **Platforms:** Docker Compose, Cloudron, Build from Source
- **Requires:** MariaDB, PHP, Node.js
- **Tags:** MariaDB, Symfony, Community, Budget Management, Docker Compose, Email notifications, Rewards, Api Platform

## Docker images

- [`registry.gitlab.com/loot-project/loot-app`](https://registry.gitlab.com/loot-project/loot-app)

## What is Loot?

Loot is a web application for communities that run a contributive budget: members log their contributions and claim rewards (retributions) against a budget created and overseen by a referent. Features shipped in its releases include a wizard to create a budget, archiving of finished budgets, activities used to classify contributions, notifications to the referent when somebody claims a retribution, password recovery and welcome/password emails to new contributors. An official demo lets people try it before installing. Operators can deploy it with a production Docker Compose stack (nginx plus php-fpm against MariaDB), on Cloudron from the project's GitLab container registry, or by building from source with PHP 8.2+, Symfony 6.4, Composer and Yarn. The project describes itself as still work in progress, with limited extension points apart from installing plugins as Symfony bundles, and a read-only API built on API Platform that is documented as under development.

## Should you self-host Loot?

Loot scores **48/100** on selfhost.directory ([how scoring works](https://selfhost.directory/scoring)) and ranks **#20 of 32** in [Collaboration](https://selfhost.directory/collaboration).

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is agpl-3.0-licensed.

Its closest alternative on selfhost.directory is [penpot](https://selfhost.directory/project/penpot) (84/100, 62 421 stars). It scores higher overall, so compare the two before you pick. [See Loot vs penpot side by side.](https://selfhost.directory/compare/loot-app-vs-penpot)

## Features

- Budget archiving
- Budget creation wizard
- Contribution classification
- Contributive budget management
- Email notifications
- Mobile-friendly web UI
- Password Recovery
- Plugin Support
- Public contribution views
- REST API (… in progress)
- Retribution claims

## How to install Loot

### Install Loot with Docker Compose

Requirements: An available SQL Server like MariaDB

Environment variables:

```
APP_ROOT_PASSWORD, APP_ROOT_MAIL, APP_LOCALE, DATABASE_URL, MAILER_DSN, MAILER_SENDER
```

Copy the files in production and configure your docker-compose as you want.

And run : `docker-compose -f docker-compose.yml -p "loot-prod" up -d`

Note: A docker-compose.yml.dist plus an nginx template are provided under support/docker/production; the app initializes or upgrades the database on first start.

### Install Loot with Cloudron

Requirements: Docker

Environment variables:

```
APP_ROOT_PASSWORD, APP_ROOT_MAIL
```

```bash
cloudron install --image registry.gitlab.com/loot-project/loot-app:cloudron-[0-9]+stable --location <install_url>
```

Note: Configuration and plugins are edited over FTP in /app/data/.env.local and /app/data/plugins.

### Install Loot with Build from Source

Environment variables:

```
APP_ROOT_PASSWORD, APP_LOCALE, DATABASE_URL, MAILER_DSN, MAILER_SENDER, MAILER_REDIRECT_TO
```

```
git clone https://gitlab.com/loot-project/loot-app ./loot
cd loot
```

```
composer install --no-dev
yarn install
yarn encore prod
```

Note: Set up .env.local from .env, create the database with Doctrine console commands and serve the public folder from an Apache virtual host.

## Loot alternatives

- [piglet](https://selfhost.directory/project/piglet): Self-hosted, open-source budget manager for tracking household expenses, sharing budgets, and generating monthly reports with a web UI and API. (compare: https://selfhost.directory/compare/loot-app-vs-piglet)
- [BudgetBee](https://selfhost.directory/project/budgetbee): A self-hosted, open-source personal finance app for transactions, category budgets, accounts, net worth and upcoming bills, deployed with one Docker Compose file. (compare: https://selfhost.directory/compare/budgetbee-vs-loot-app)
- [IHateMoney](https://selfhost.directory/project/ihatemoney): Self-hosted, open-source shared budget app tracking who paid what and settling group bills, with REST API, multi-currency support, Docker image and pip install. (compare: https://selfhost.directory/compare/ihatemoney-vs-loot-app)
- [Personal Management System](https://selfhost.directory/project/personal-management-system): Open-source, self-hosted personal data hub: notes, contacts, encrypted passwords, payments, schedules and files, run via Docker Compose with MariaDB. (compare: https://selfhost.directory/compare/loot-app-vs-personal-management-system)
- [Aurum](https://selfhost.directory/project/aurum): Self-hosted personal finance OS tracking cash flow, net worth, budgets, crypto, and recurring payments with mobile-first UI and backup/restore. (compare: https://selfhost.directory/compare/aurum-vs-loot-app)
- [Koillection](https://selfhost.directory/project/koillection): Self-hosted, open-source collection manager for tracking physical collections of all kinds, with custom metadata, tags, wishlists, loans and a REST API. (compare: https://selfhost.directory/compare/koillection-vs-loot-app)
- [MoneyMatter](https://selfhost.directory/project/moneymatter): MoneyMatter is a self-hosted, open-source personal finance app for tracking accounts, budgets, investments, and net worth with bank sync and AI. (compare: https://selfhost.directory/compare/loot-app-vs-moneymatter)
- [VoucherVault](https://selfhost.directory/project/vouchervault): Self-hosted Django app to manage digital coupons, vouchers, loyalty cards and gift cards with PWA offline access, expiry alerts, OIDC login, and stats API. (compare: https://selfhost.directory/compare/loot-app-vs-vouchervault)

## More in Collaboration

- [Lowcoder](https://selfhost.directory/project/lowcoder): Open-source low-code platform for internal tools and customer apps with visual builder, 120+ components, 60+ data sources, and Docker self-hosting.
- [Mailcow](https://selfhost.directory/project/mailcow): Open-source mail server suite providing email hosting with spam filtering, antivirus, webmail, calendar and contacts via Docker Compose installation.
- [mailez](https://selfhost.directory/project/mailez): A self-hosted email platform with SMTP, IMAP, POP3, CardDAV, CalDAV, a React webmail client, and admin console — all deployed via a single Docker Compose command.
- [mattermost](https://selfhost.directory/project/mattermost): Mattermost is a self-hosted collaboration platform with channels, threads, file sharing, voice calls and playbooks for DevSecOps, IT service desk and incident response.
- [Mediagoblin](https://selfhost.directory/project/mediagoblin): GNU MediaGoblin is a free software media publishing platform for sharing photos, videos, and other media in a decentralized and freedom-respecting environment.
- [Mediawiki](https://selfhost.directory/project/mediawiki): MediaWiki is a collaboration and documentation platform used by tens of thousands of websites and organizations. It powers Wikipedia and is known for being powerful, multilingual, free, open-source, extensible, customizable, and reliable.
- [memEx](https://selfhost.directory/project/memex): A structured personal knowledge base inspired by zettlekasten and org-mode, designed for notes, contexts, and pipelines with multi-user support and privacy controls.
- [mindwendel](https://selfhost.directory/project/mindwendel): mindwendel is a self-hosted, open-source brainstorming tool for teams to create, upvote, and organize ideas in real time with AI-powered suggestions.
- [MiroTalk P2P](https://selfhost.directory/project/mirotalk-p2p): Open-source, self-hosted WebRTC video conferencing with peer-to-peer calls, screen sharing, chat, whiteboard and recording for small groups.
- [mqp-server](https://selfhost.directory/project/mqp-server): mqp-server is a self-hosted, open-source Node.js server for MusiqPad, enabling real-time music streaming and chat with YouTube/SoundCloud playback.
- [Nautilo](https://selfhost.directory/project/nautilo): Nautilo is a self-hosted, open-source workspace where people and AI agents collaborate in shared Rooms. Run it on your own infrastructure with Docker.
- [Neko](https://selfhost.directory/project/neko): n.eko runs a Linux desktop in Docker and streams it via WebRTC, letting multiple people browse together, host watch parties, or access web apps remotely from any device.

## Links

- [Homepage](https://gitlab.com/loot-project/loot-app)
- [Demo](http://loot-demo.soletic.org/)
- [GitLab repository](https://gitlab.com/loot-project/loot-app)
- [User guide (French)](https://loot-project.gitlab.io/userguide)

---
Source: https://selfhost.directory/project/loot-app