Skip to content
Klutch.sh Docs

Deploying Tamari

Introduction

Tamari is a beautiful, self-hosted recipe manager designed to store, organize, and share your favorite recipes. With a modern interface and powerful features, Tamari makes cooking more enjoyable and organized.

Key highlights of Tamari:

  • Modern Interface: Clean, responsive design for all devices
  • Recipe Import: Import recipes from URLs with automatic parsing
  • Categories and Tags: Organize recipes by cuisine, type, or custom tags
  • Meal Planning: Plan your meals for the week
  • Shopping Lists: Generate shopping lists from recipes
  • Recipe Scaling: Adjust serving sizes automatically
  • Nutritional Info: Track nutritional information
  • Multi-User: Share recipes with family members
  • Offline Support: Access recipes without internet
  • Print Friendly: Print recipes in a clean format

This guide walks through deploying Tamari on Klutch.sh using Docker.

Why Deploy Tamari on Klutch.sh

Deploying Tamari on Klutch.sh provides several advantages:

Simplified Deployment: Klutch.sh automatically detects your Dockerfile and builds Tamari without complex orchestration.

Persistent Storage: Attach persistent volumes for recipes and images.

HTTPS by Default: Secure access to your recipes from anywhere.

GitHub Integration: Connect your configuration repository for automatic redeployments.

Prerequisites

Before deploying Tamari on Klutch.sh, ensure you have:

Deploying Tamari on Klutch.sh

    Create Your Repository

    Create a new GitHub repository with a Dockerfile for Tamari:

    FROM alexbates/tamari:latest
    

    ENV PUID=1000
    ENV PGID=1000
    ENV SECRET_KEY=${SECRET_KEY}
    

    EXPOSE 5000
    

    VOLUME ["/app/data"]

    Push to GitHub

    Initialize and push your repository to GitHub with your Dockerfile.

    Create a New Project on Klutch.sh

    Navigate to the Klutch.sh dashboard and create a new project.

    Create a New App

    Within your project, create a new app and connect your GitHub repository.

    Configure HTTP Traffic

    In the deployment settings:

    • Select HTTP as the traffic type
    • Set the internal port to 5000

    Set Environment Variables

    Configure the following environment variables:

    VariableValue
    PUID1000
    PGID1000
    SECRET_KEYGenerate with openssl rand -hex 32

    Attach Persistent Volumes

    Add the following volumes:

    Mount PathRecommended SizePurpose
    /app/data5 GBRecipes, images, and database

    Deploy Your Application

    Click Deploy to start the build process.

    Access Tamari

    Once deployment completes, access Tamari at your app URL.

Configuration

Adding Recipes

Add recipes manually:

  1. Click Add Recipe
  2. Enter recipe details (title, ingredients, instructions)
  3. Upload a photo
  4. Add tags and categories
  5. Save the recipe

Importing from URLs

Import recipes from websites:

  1. Click Import Recipe
  2. Paste the recipe URL
  3. Review and edit the parsed recipe
  4. Save to your collection

Meal Planning

Plan your meals:

  1. Navigate to Meal Planner
  2. Click on a day to add a meal
  3. Select recipes from your collection
  4. View your week at a glance

Shopping Lists

Generate shopping lists:

  1. Select recipes for your shopping trip
  2. Click Generate Shopping List
  3. Edit quantities as needed
  4. Check off items while shopping

Additional Resources

Conclusion

Deploying Tamari on Klutch.sh gives you a beautiful recipe management system with automatic builds, persistent storage, and secure HTTPS access. Organize your recipes, plan meals, and generate shopping lists with ease.