Self-host vue-salt-rim
v5.9.0Vue-based web client for Bar Assistant cocktail management
- Stars
- 151
- Port
- 8080 (HTTP web client)
- Requires
- Bar Assistant API server, Meilisearch
barassistant/salt-rim
What is vue-salt-rim?
Salt Rim is a Vue 3 web client that connects to a self-hosted Bar Assistant server instance. It provides a beautiful UI for managing cocktail recipes, ingredients, shopping lists, menus, and more. It builds to static files that can be hosted anywhere, or run via Docker. Features include dark theme, PWA support, multi-language, QR code generation, and powerful search and filtering. The self-hosted edition is free and MIT-licensed, while the cloud service offers paid tiers.
Should you self-host vue-salt-rim?
vue-salt-rim scores 51/100 on selfhost.directory (how scoring works) and ranks #9 of 18 in Recipe Management. It has 151 GitHub stars.
It shipped 19 stable releases in the past year. The latest, v5.9.0, came out on 27 October 2026. New versions land roughly every 2 weeks.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Vue.
Its closest alternative on selfhost.directory is Mealie (75/100, 13 709 stars). It scores higher overall, so compare the two before you pick. See vue-salt-rim vs Mealie side by side.
Features
- Cocktail recipe management
- Multi-language Support
- Powerful search and filtering
- Progressive Web App (PWA)
- QR Code Generation
- Recipe import from websites
- Recipe scaling and cost calculation
- Recipe sharing and export
- Shopping List Management
vue-salt-rim README
FAQ
Where do I find more recipes?
Community databases at zhdenny/bar_assistant_database and bar-assistant/data on GitHub, or import from officially supported sites like PunchDrink, Imbibe, Liquor.com, etc.
Where can I find API documentation?
Visit /docs path on your API instance, e.g., https://your-bar-api-server.com/docs
How do I check logs?
Use docker compose logs bar-assistant and docker compose logs salt-rim. Some logs are also in /var/www/cocktails/storage/logs/laravel.log inside the container.
How do I update Meilisearch?
Either delete the Meilisearch container and volume and recreate (easy way), or follow Meilisearch official dump/restore guide (proper way).
How do I backup my data?
Run the CLI command: docker compose exec bar-assistant php artisan bar:full-backup to create a full backup zip file.
How do I disable user registrations?
Set the ALLOW_REGISTRATION environment variable to false.
Why is my site search / ingredient search not working?
Search tokens may be outdated or indexes empty after Meilisearch update. Force update tokens and sync indexes.
Why am I missing some features in web app?
Browser caching may cause missing features. Try another browser or incognito mode. Some features require HTTPS context (clipboard API, screen wake lock).
Why do I get "Resource not found" error when accessing Bar Assistant through a reverse proxy?
The reverse proxy is forwarding the full path including the prefix instead of stripping it. The application expects requests without the path prefix.
Why do I get "Unable to connect to X API server." on a login page?
The client cannot reach the API server. Check that the API server is running and reachable from your browser.
More in Recipe Management
Bar AssistantSelf-hosted, open-source cocktail recipe manager with ingredient inventory, bar management, shopping lists, and menu creation for home bartenders.
CookCLIA self-hosted, open-source recipe manager in one binary: it parses plain .cook files, builds shopping lists and meal plans, and serves a browsable cookbook web UI.
fork.recipesSelf-hosted Django recipe manager with AI tools for scraping, generating, translating, and narrating recipes.
groceriesOpen-source self-hosted grocery list app with reliable real-time sync, offline support, multiple lists, store aisle sorting, and Tandoor recipe import.
grocyA self-hosted, open-source household ERP: track grocery stock, shopping lists, recipes, meal plans, chores, tasks, batteries and devices, with a full REST API.
kcalSelf-hosted, open-source personal food nutrition journal for tracking calories, macros, recipes, and food journal entries with goal setting and meal planning.
KitchenOwlKitchenOwl is a self-hosted grocery list and recipe manager. The backend is made with Flask and the frontend with Flutter. Easily add items to your shopping list before you go shopping. You can also create recipes and add items based on what you want to cook.
MealieSelf-hosted recipe management with meal planning and shopping lists. Import recipes from URLs or create manually via web editor.
norishA self-hosted, open-source recipe manager for households: import recipes from links, videos or photos, plan meals and share grocery lists in real time.
OpenEatsOpenEats is a self-hosted, open-source recipe manager for personal collections with grocery lists, search, and serving adjustments.
pantry-hostPantry Host is a self-hosted, open-source PWA for recipes, pantry, cookware, and grocery lists — runs on your hardware with offline support.
recipe-buddySelf-hosted web app that scrapes recipe metadata from web pages and imports them into Grocy for meal planning, with ingredient matching and a simple Docker deployment.
0 comments