Bar Assistant logo

Bar Assistant

All-in-one solution for managing your home bar

Alternative to: barsys

Bar Assistant screenshot

About Versions (103)

v6.0.0

2026-08-16

This release features a major code refactoring, reorganization of API routes, transition to a multi-inventory system, and the addition of OIDC SSO provider.

v6.0.0-rc1

2026-08-14

This release features a major backend architecture rewrite, introducing a multi-inventory system and extensive API route reorganizations and removals.

v5.15.4

2026-08-08

Fixed an issue where HTML entities were incorrectly encoded during markdown export.

v5.15.3

2026-07-09

Fixed missing request validation for amount and units when creating new cocktails.

v5.15.2

2026-06-14

Fixed the release target.

v5.15.1

2026-06-14

Implemented rate limiting for the authentication endpoint.

v5.15.0

2026-04-26

Introduces AI cocktail image generation via OpenAI and Gemini providers and fixes a shopping list bug when adding ingredients to the shelf.

v5.14.0

2026-04-18

Updated AI prompts and fixed email header links.

v5.13.2

2026-03-08

Fixed public cocktail identification, added image URL validation, and updated a vulnerable dependency.

v5.13.1

2026-02-02

Fixed an issue where datapack imports attempted to set incorrect unknown columns.

v5.13.0

2026-02-01

Introduces Kanidm SSO, generative AI endpoints for recipe and ingredient data, and removes feeds while improving image cleanup and database queries.

v5.12.0

2026-01-11

Added filters property and collection_id filter to the public cocktails index, including a collections list for shared bars.

v5.11.2

2025-12-29

Fixed a crash that occurred when metrics were enabled.

v5.11.1

2025-12-27

Fixed issues with datapack imports and empty menus when adding ingredients.

v5.11.0

2025-12-18

Introduced HTTP proxy and client certificate environment variables for scraping, improved multi-word search results, and fixed memory errors during large bar exports.

v5.10.0

2025-12-13

Added filtering for locked cocktails and sorting for potential bar shelf ingredients, and updated the Docker image to PHP 8.4.

v5.9.3

2025-11-25

Fixed a bug related to shopping list access checks.

v5.9.2

2025-11-11

Fixed errors occurring during CSV imports.

v5.9.1

2025-11-02

The public menu can now be enabled independently of the is_public bar setting.

v5.9.0

2025-10-15

Introduced new public endpoints for bar data, including menus and cocktails, and fixed various indexing and data import bugs.

v5.8.1

2025-09-28

Fixed a missing API ability on the import/cocktail endpoint.

v5.8.0

2025-08-19

Added a new endpoint to sync bar data with the default datapack and improved recommendation logic based on shelf ingredients, recency, and negative tags.

v5.7.0

2025-08-16

Introduces parent cocktail datapack imports, public Bar endpoints, optional HTML content for scraping, and updated scraping compliance and recipes.

v5.6.1

2025-08-07

Fixed an error occurring during the import of new datapack data.

v5.6.0

2025-07-19

Introduced cocktail recipe parent ID tracking for varieties and riffs, added recipe year, and fixed scraping error messages and calculator import issues.

v5.5.1

2025-06-11

Fixed issues with duplicated cocktail recipe names in datapack exports and ingredient filtering counts.

v5.5.0

2025-05-28

Added image upload support for glass types, recipe import support for feed items, and fixed missing volume data in datapack exports.

v5.4.2

2025-05-24

Fixed an issue where menu cocktails were not being removed correctly.

v5.4.1

2025-05-19

Fixed an issue where recipe matching failed for complex ingredients with multiple parts.

v5.4.0

2025-05-17

Added Zitadel SSO provider, implemented ABV recalculation upon dilution changes, and fixed a materialized path migration issue.

v5.3.0

2025-05-01

Added PocketId as an SSO provider and introduced import support for cocktailexplorer.co.

v5.2.5

2025-04-29

Fixed an issue where menu items displayed the incorrect thumbnail path.

v5.2.4

2025-04-26

Fixed an issue where incorrect thumbnail URLs were being synced to the search engine.

v5.2.3

2025-04-07

Fixed an issue where the state query string was always sent when using Authelia as an SSO provider.

v5.2.2

2025-04-06

The automatic ingredient units filler now attempts to convert values to the default bar unit.

v5.2.1

2025-04-05

Fixed synchronization issues between the OpenAPI schema and certain API responses.

v5.2.0

2025-03-31

Introduced password login control, external RSS feeds support, ingredient units, and updated API schemas and permissions.

v5.1.0

2025-03-22

Updated Image, CocktailBasic, and IngredientBasic schemas, added a bar optimization endpoint, and implemented a cocktail tag index alongside various bug fixes.

v5.0.4

2025-03-20

Fixed a cast error that occurred when duplicating recipes.

v5.0.3

2025-03-16

Optimized the execution of ancestors queries for better performance.

v5.0.2

2025-03-13

Added missing menu schema changes and implemented type validation for route parameters.

v5.0.1

2025-03-11

Fixed a SQL error occurring when filtering by bar ingredients.

v5.0.0

2025-03-11

Major release introducing SSO support, nested ingredient hierarchies, and various query optimizations.

v4.4.2

2025-03-08

The release enables publishing images to GitHub Container Registry and addresses a security vulnerability in dependencies.

v4.4.1

2025-02-15

Added wildcard support for METRICS_ALLOWED_IPS, included calculators in datapack exports, and fixed the Diffords guide scraper.

v4.4.0

2025-02-06

Introduces calculators for syrup and batch formulas, Prometheus metrics support, a new random sort attribute for cocktails, and scraping support for Crafted Pour recipes.

v4.3.2

2025-01-06

Improved error handling for scraping recipes from unsupported websites.

v4.3.1

2025-01-02

CSV import now supports case-insensitive category matching.

v4.3.0

2025-01-01

This minor release introduces a shelf migration command, CSV ingredient imports, Sentry error reporting, and various schema and endpoint enhancements.

v4.2.7

2024-12-29

Added a CSV import endpoint for ingredients, updated cocktail schemas, enhanced filtering for cocktail methods, and integrated Sentry error reporting.

v4.2.6

2024-12-23

Fixed an issue with the counting of substitute ingredient IDs.

v4.2.5

2024-12-21

Fixed ingredient overcounting in recipe matching and added a missing filter attribute to the cocktails endpoint.

v4.2.4

2024-12-15

Optimized ingredients list queries and SQLite performance, while fixing bugs related to imports, cloud instance image validation, and markdown export encoding.

v4.2.3

2024-12-08

Fixed an unhandled exception occurring when a menu cocktail has a null currency.

v4.2.2

2024-12-07

This update introduces confirmation requirements for login, optimizes Meilisearch token updates, adds image count validation, and fixes export download permissions.

v4.2.1

2024-12-03

Fixed search token clearing, improved indexing for large datasets, and corrected personal access token middleware and price calculation logic.

v4.2.0

2024-11-30

Introduces new endpoints for cocktail prices, menu exports, and bar shelf management, alongside improved schema properties and worker role support.

v4.1.0

2024-11-15

Introduced bar shelves for ingredient management with new API endpoints, filtering, and sorting, and added support for bar resource images.

v4.0.4

2024-11-07

Fixed issues with shelf ingredient validation, Docker entry point directory creation, and export ID generation.

v4.0.3

2024-10-27

Fixed an incorrect endpoint method in the documentation.

v4.0.2

2024-09-22

Fixed a bug in the bar import command related to incorrect file path checking.

v4.0.1

2024-09-21

Fixed a bug affecting the correct filtering of cocktails when substitutes and other filters were applied simultaneously.

v4.0.0

2024-09-20

Major release introducing unprivileged Docker users, a public JSON schema for recipes, expanded data export formats, and extensive API restructuring.

v3.19.1

2024-09-09

Fixed an issue where base data was missing from recipe exports.

v3.19.0

2024-08-26

Updated OpenAPI specification generation to be code-driven and improved ingredient matching for cocktails.

v3.18.0

2024-08-03

Introduced price categories, ingredient pricing, and a new json+ld cocktail share type, along with the intl PHP extension in docker images.

v3.17.1

2024-07-21

Fixed an issue where glass volume was not nullable.

v3.17.0

2024-06-16

Introduced support for complex ingredients with automatic shelf matching and updated ingredient attributes, alongside a punchdrink scraper improvement and ownership validation fix.

v3.16.0

2024-06-01

Upgraded to Laravel 11, added a command for merging ingredients, and optimized database queries for several endpoints.

v3.15.0

2024-05-25

Added bar settings and expanded CocktailIngredient and Glass schemas with volume and unit support, including a new query string for unit selection.

v3.14.0

2024-05-11

Added a bar ownership transfer endpoint, enhanced docker runtime logging, and optimized container startup permissions and demo environment settings.

v3.13.2

2024-05-07

Fixed a fatal error during JSON collection imports and resolved missing unique IDs for resources with identical names in exports.

v3.13.1

2024-05-07

Fixed a fatal error during unknown JSON collection imports and resolved missing unique IDs for resources with identical names in exports.

v3.13.0

2024-05-03

Updated cocktail schema with volume, alcohol units, and calories, added the KindredCocktails scraper, and fixed various ABV and import bugs.

v3.12.1

2024-04-21

Fixed parsing of units in the CocktailParty scraper and applied other minor scraping improvements.

v3.12.0

2024-04-07

Added recipe exporting endpoints, a specific ingredients filter for cocktails, and public ID/slug fields to the public menu response, alongside a scraper fix.

v3.11.0

2024-03-13

Introduced cocktail copying and password check endpoints, consolidated recipe sharing, and fixed search result visibility.

v3.10.0

2024-02-17

Introduced a /tokens endpoint for creating and managing custom Personal Access Tokens and added an optional token_name parameter to the login endpoint.

v3.9.0

2024-01-28

Introduced a bar menu with new endpoints, added a slug column to the bars table, and enabled timestamp imports for recipe data.

v3.8.0

2024-01-13

Added favorite_tags to stats, a type option for recipes export, and fixed several data import and search issues.

v3.7.0

2024-01-05

Introduced cocktails filters, CSV export, a recommendation endpoint, and bar membership settings while removing the PARENT_INGREDIENT_SUBSTITUTE environment variable.

v3.6.0

2023-12-28

Introduced a new cloud offering and homepage, added a total bar members count, and enabled editing of existing images.

v3.5.2

2023-12-26

Added missing timestamps for ingredients and fixed user image cleanup when deleting users via CLI.

v3.5.1

2023-12-24

Fixed an issue with account deletion emails and updated documentation with missing endpoints.

v3.5.0

2023-12-21

Introduced transactional emails for account changes, added bar status management with new endpoints, and implemented image resizing and styling updates.

v3.4.0

2023-12-10

Introduced ingredient exclusion filters for cocktails, updated Meilisearch support, and refined Docker images and API indexing.

v3.3.1

2023-12-01

Added missing mail confirmation for user creation via the users endpoint.

v3.3.0

2023-11-30

Introduces email functionality including password resets and account verification, enables SQLite WAL mode, and updates password and tag matching logic.

v3.2.0

2023-11-17

Updated base cocktails and ingredients, added new CLI commands for recipe import/export and user deletion, and deprecated zip-based data commands.

v3.1.1

2023-10-30

Fixed an issue where bar exports joined incorrect columns, causing import errors.

v3.1.0

2023-10-22

Introduced zip import and export commands for bars and enabled collection sharing among bar members via a new endpoint and property.

v3.0.3

2023-10-20

Fixed an issue where the cocktail share endpoint failed when an ingredient lacked a category.

v3.0.2

2023-10-14

Added missing ingredient notes and substitute amounts to the public recipe properties.

v3.0.1

2023-10-12

Fixed user role update issues and changed the default role for joining a bar to Guest.

v3.0.0

2023-10-07

Introduces support for multiple bars, granular user roles, and significant API schema updates, including several removed and renamed endpoints.

v2.6.0

2023-09-20

Added version 3 export options and fixed missing migrations on first start.

v2.5.4

2023-09-09

Fixed issues regarding lingering notes after cocktail deletion and a missing environment variable.

v2.5.3

2023-08-18

Fixed issues with cocktail substitute mapping during collection imports and Meilisearch syncing migration failures.

v2.5.2

2023-08-15

Fixed an issue where utensil information was missing from the GET cocktail endpoint.

v2.5.1

2023-08-15

Fixed an issue where ratings were missing.

v2.5.0

2023-08-14

Introduces new share endpoints, utensils support, ingredient calculations, and several schema updates to cocktails and ingredients.

v2.4.0

2023-08-04

Added a new scraper, expanded StatsResponse and ingredients endpoint, and removed certain fields from the Cocktail schema.

v2.3.0

2023-07-30

Introduces new cocktail query filters, an endpoint for adding multiple cocktails to collections, and various bug fixes.