# Bar Assistant Backend

Bar Assistant Backend is a self-hosted media applications app. Self-hosted backend API server for Bar Assistant, an all-in-one app for managing home bar cocktail recipes with features like ingredient substitutes, ABV (alcohol by volume) calculations, and unit switching. It is open source and self-hosted, installable on Proxmox, Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1036/bar-assistant-backend

## Description

Self-hosted backend API server for Bar Assistant, an all-in-one app for managing home bar cocktail recipes with features like ingredient substitutes, ABV (alcohol by volume) calculations, and unit switching.

## Platform availability

Available on 2 of 9 platforms: Unraid, Proxmox.

## Health score

73/100 (Good), based on 3 of 4 factors.
- Maintained: 100 (last commit 16 days ago)
- Popular: 61 (1,101 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- GitHub: https://github.com/karlomikus/bar-assistant
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=bar-assistant
- Docker Hub: https://hub.docker.com/r/barassistant/server
- Official website: https://barassistant.app/
- Unraid: https://ca.unraid.net/apps/bar-assistant-backend-1yp889x0i39dx5?q=Bar-Assistant---Backend
- Documentation: https://docs.barassistant.app

## Common questions

### Does the backend repository include the web interface?

No, the repository only contains the API server. For an easy-to-use web client, use Salt Rim.

### How should I tag the Docker image for updates?

There is no latest tag, so specify a version tag such as major, minor, patch, or dev. The dev tag is not recommended for production.

### How do I load the built-in recipes and ingredients?

When creating a new bar, you can choose to start with cocktails and ingredients already included. To pull updated standard recipes, open the bar edit page and click Synchronize data.

### How can another user join a bar?

The bar owner can add the user as a member or share an invite code. The invite code and invite link are available in the list of bars and can be toggled on or off.

### What should I check if the login page cannot reach the API server?

This usually means the client cannot reach the API server. Restart the API server and check Docker.

### Can I import and export bar data?

Recipes can be exported in formats such as JSON, YAML, and Markdown. Ingredients can be bulk imported via CSV.

---
Source: Our Local Host (https://ourlocalhost.com/app/1036/bar-assistant-backend), the self-hosted and open-source app directory.