Bar Assistant
All-in-one solution for managing your home bar
Alternative to: barsys
v6.0.0
2026-08-16This 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-14This release features a major backend architecture rewrite, introducing a multi-inventory system and extensive API route reorganizations and removals.
v5.15.4
2026-08-08Fixed an issue where HTML entities were incorrectly encoded during markdown export.
v5.15.3
2026-07-09Fixed missing request validation for amount and units when creating new cocktails.
v5.15.2
2026-06-14Fixed the release target.
v5.15.1
2026-06-14Implemented rate limiting for the authentication endpoint.
v5.15.0
2026-04-26Introduces 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-18Updated AI prompts and fixed email header links.
v5.13.2
2026-03-08Fixed public cocktail identification, added image URL validation, and updated a vulnerable dependency.
v5.13.1
2026-02-02Fixed an issue where datapack imports attempted to set incorrect unknown columns.
v5.13.0
2026-02-01Introduces 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-11Added filters property and collection_id filter to the public cocktails index, including a collections list for shared bars.
v5.11.2
2025-12-29Fixed a crash that occurred when metrics were enabled.
v5.11.1
2025-12-27Fixed issues with datapack imports and empty menus when adding ingredients.
v5.11.0
2025-12-18Introduced 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-13Added 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-25Fixed a bug related to shopping list access checks.
v5.9.2
2025-11-11Fixed errors occurring during CSV imports.
v5.9.1
2025-11-02The public menu can now be enabled independently of the is_public bar setting.
v5.9.0
2025-10-15Introduced new public endpoints for bar data, including menus and cocktails, and fixed various indexing and data import bugs.
v5.8.1
2025-09-28Fixed a missing API ability on the import/cocktail endpoint.
v5.8.0
2025-08-19Added 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-16Introduces parent cocktail datapack imports, public Bar endpoints, optional HTML content for scraping, and updated scraping compliance and recipes.
v5.6.1
2025-08-07Fixed an error occurring during the import of new datapack data.
v5.6.0
2025-07-19Introduced 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-11Fixed issues with duplicated cocktail recipe names in datapack exports and ingredient filtering counts.
v5.5.0
2025-05-28Added 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-24Fixed an issue where menu cocktails were not being removed correctly.
v5.4.1
2025-05-19Fixed an issue where recipe matching failed for complex ingredients with multiple parts.
v5.4.0
2025-05-17Added Zitadel SSO provider, implemented ABV recalculation upon dilution changes, and fixed a materialized path migration issue.
v5.3.0
2025-05-01Added PocketId as an SSO provider and introduced import support for cocktailexplorer.co.
v5.2.5
2025-04-29Fixed an issue where menu items displayed the incorrect thumbnail path.
v5.2.4
2025-04-26Fixed an issue where incorrect thumbnail URLs were being synced to the search engine.
v5.2.3
2025-04-07Fixed an issue where the state query string was always sent when using Authelia as an SSO provider.
v5.2.2
2025-04-06The automatic ingredient units filler now attempts to convert values to the default bar unit.
v5.2.1
2025-04-05Fixed synchronization issues between the OpenAPI schema and certain API responses.
v5.2.0
2025-03-31Introduced password login control, external RSS feeds support, ingredient units, and updated API schemas and permissions.
v5.1.0
2025-03-22Updated 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-20Fixed a cast error that occurred when duplicating recipes.
v5.0.3
2025-03-16Optimized the execution of ancestors queries for better performance.
v5.0.2
2025-03-13Added missing menu schema changes and implemented type validation for route parameters.
v5.0.1
2025-03-11Fixed a SQL error occurring when filtering by bar ingredients.
v5.0.0
2025-03-11Major release introducing SSO support, nested ingredient hierarchies, and various query optimizations.
v4.4.2
2025-03-08The release enables publishing images to GitHub Container Registry and addresses a security vulnerability in dependencies.
v4.4.1
2025-02-15Added wildcard support for METRICS_ALLOWED_IPS, included calculators in datapack exports, and fixed the Diffords guide scraper.
v4.4.0
2025-02-06Introduces 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-06Improved error handling for scraping recipes from unsupported websites.
v4.3.1
2025-01-02CSV import now supports case-insensitive category matching.
v4.3.0
2025-01-01This minor release introduces a shelf migration command, CSV ingredient imports, Sentry error reporting, and various schema and endpoint enhancements.
v4.2.7
2024-12-29Added a CSV import endpoint for ingredients, updated cocktail schemas, enhanced filtering for cocktail methods, and integrated Sentry error reporting.
v4.2.6
2024-12-23Fixed an issue with the counting of substitute ingredient IDs.
v4.2.5
2024-12-21Fixed ingredient overcounting in recipe matching and added a missing filter attribute to the cocktails endpoint.
v4.2.4
2024-12-15Optimized 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-08Fixed an unhandled exception occurring when a menu cocktail has a null currency.
v4.2.2
2024-12-07This update introduces confirmation requirements for login, optimizes Meilisearch token updates, adds image count validation, and fixes export download permissions.
v4.2.1
2024-12-03Fixed search token clearing, improved indexing for large datasets, and corrected personal access token middleware and price calculation logic.
v4.2.0
2024-11-30Introduces new endpoints for cocktail prices, menu exports, and bar shelf management, alongside improved schema properties and worker role support.
v4.1.0
2024-11-15Introduced bar shelves for ingredient management with new API endpoints, filtering, and sorting, and added support for bar resource images.
v4.0.4
2024-11-07Fixed issues with shelf ingredient validation, Docker entry point directory creation, and export ID generation.
v4.0.3
2024-10-27Fixed an incorrect endpoint method in the documentation.
v4.0.2
2024-09-22Fixed a bug in the bar import command related to incorrect file path checking.
v4.0.1
2024-09-21Fixed a bug affecting the correct filtering of cocktails when substitutes and other filters were applied simultaneously.
v4.0.0
2024-09-20Major release introducing unprivileged Docker users, a public JSON schema for recipes, expanded data export formats, and extensive API restructuring.
v3.19.1
2024-09-09Fixed an issue where base data was missing from recipe exports.
v3.19.0
2024-08-26Updated OpenAPI specification generation to be code-driven and improved ingredient matching for cocktails.
v3.18.0
2024-08-03Introduced 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-21Fixed an issue where glass volume was not nullable.
v3.17.0
2024-06-16Introduced 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-01Upgraded to Laravel 11, added a command for merging ingredients, and optimized database queries for several endpoints.
v3.15.0
2024-05-25Added 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-11Added a bar ownership transfer endpoint, enhanced docker runtime logging, and optimized container startup permissions and demo environment settings.
v3.13.2
2024-05-07Fixed a fatal error during JSON collection imports and resolved missing unique IDs for resources with identical names in exports.
v3.13.1
2024-05-07Fixed 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-03Updated cocktail schema with volume, alcohol units, and calories, added the KindredCocktails scraper, and fixed various ABV and import bugs.
v3.12.1
2024-04-21Fixed parsing of units in the CocktailParty scraper and applied other minor scraping improvements.
v3.12.0
2024-04-07Added 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-13Introduced cocktail copying and password check endpoints, consolidated recipe sharing, and fixed search result visibility.
v3.10.0
2024-02-17Introduced 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-28Introduced 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-13Added favorite_tags to stats, a type option for recipes export, and fixed several data import and search issues.
v3.7.0
2024-01-05Introduced cocktails filters, CSV export, a recommendation endpoint, and bar membership settings while removing the PARENT_INGREDIENT_SUBSTITUTE environment variable.
v3.6.0
2023-12-28Introduced a new cloud offering and homepage, added a total bar members count, and enabled editing of existing images.
v3.5.2
2023-12-26Added missing timestamps for ingredients and fixed user image cleanup when deleting users via CLI.
v3.5.1
2023-12-24Fixed an issue with account deletion emails and updated documentation with missing endpoints.
v3.5.0
2023-12-21Introduced transactional emails for account changes, added bar status management with new endpoints, and implemented image resizing and styling updates.
v3.4.0
2023-12-10Introduced ingredient exclusion filters for cocktails, updated Meilisearch support, and refined Docker images and API indexing.
v3.3.1
2023-12-01Added missing mail confirmation for user creation via the users endpoint.
v3.3.0
2023-11-30Introduces email functionality including password resets and account verification, enables SQLite WAL mode, and updates password and tag matching logic.
v3.2.0
2023-11-17Updated 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-30Fixed an issue where bar exports joined incorrect columns, causing import errors.
v3.1.0
2023-10-22Introduced 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-20Fixed an issue where the cocktail share endpoint failed when an ingredient lacked a category.
v3.0.2
2023-10-14Added missing ingredient notes and substitute amounts to the public recipe properties.
v3.0.1
2023-10-12Fixed user role update issues and changed the default role for joining a bar to Guest.
v3.0.0
2023-10-07Introduces support for multiple bars, granular user roles, and significant API schema updates, including several removed and renamed endpoints.
v2.6.0
2023-09-20Added version 3 export options and fixed missing migrations on first start.
v2.5.4
2023-09-09Fixed issues regarding lingering notes after cocktail deletion and a missing environment variable.
v2.5.3
2023-08-18Fixed issues with cocktail substitute mapping during collection imports and Meilisearch syncing migration failures.
v2.5.2
2023-08-15Fixed an issue where utensil information was missing from the GET cocktail endpoint.
v2.5.1
2023-08-15Fixed an issue where ratings were missing.
v2.5.0
2023-08-14Introduces new share endpoints, utensils support, ingredient calculations, and several schema updates to cocktails and ingredients.
v2.4.0
2023-08-04Added a new scraper, expanded StatsResponse and ingredients endpoint, and removed certain fields from the Cocktail schema.
v2.3.0
2023-07-30Introduces new cocktail query filters, an endpoint for adding multiple cocktails to collections, and various bug fixes.