Skip to content
Klutch.sh Docs

Deploying ManageMeals

Introduction

ManageMeals is a self-hosted meal planning and recipe management application designed to simplify your cooking routine. It provides a comprehensive platform for storing recipes, planning weekly meals, and generating shopping lists, all while keeping your data private and under your control.

Built with modern web technologies, ManageMeals offers an intuitive interface that makes meal planning enjoyable rather than a chore. Whether you’re cooking for yourself, your family, or managing a household with diverse dietary needs, ManageMeals helps you stay organized.

Key highlights of ManageMeals:

  • Recipe Management: Store and organize your recipes with ingredients, instructions, and photos
  • Meal Planning: Plan your meals for the week with a visual calendar interface
  • Shopping Lists: Automatically generate shopping lists from your meal plan
  • Recipe Import: Import recipes from URLs with automatic parsing
  • Nutritional Information: Track nutritional data for your meals
  • Categories and Tags: Organize recipes by cuisine, meal type, or custom tags
  • Search and Filter: Quickly find recipes by ingredient, name, or category
  • Serving Scaling: Automatically adjust ingredient quantities for different serving sizes
  • Multi-User Support: Share meal planning with family members
  • Mobile-Friendly: Responsive design works on phones and tablets

This guide walks through deploying ManageMeals on Klutch.sh using Docker, setting up your recipe database, and organizing your meal planning workflow.

Why Deploy ManageMeals on Klutch.sh

Deploying ManageMeals on Klutch.sh provides several advantages:

Access Anywhere: Plan meals and check recipes from your phone at the grocery store, your tablet in the kitchen, or your computer at home.

Always Available: Your meal planner runs 24/7 without keeping your home server running.

HTTPS by Default: Automatic SSL certificates keep your data secure.

Persistent Storage: Your recipes and meal plans persist across deployments.

Family Access: Share access with family members who need to view recipes or shopping lists.

Custom Domains: Use a memorable domain for your family’s meal planning hub.

Prerequisites

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

  • A Klutch.sh account
  • A GitHub account with a repository for your ManageMeals configuration
  • Basic familiarity with Docker concepts
  • (Optional) Existing recipes to import

Understanding ManageMeals Architecture

ManageMeals follows a standard web application architecture:

Backend API: Handles recipe storage, meal planning logic, and user management.

Frontend Interface: Provides the responsive web interface for interacting with your data.

Database: Stores recipes, meal plans, shopping lists, and user information.

File Storage: Manages uploaded images and attachments for recipes.

Preparing Your Repository

To deploy ManageMeals on Klutch.sh, create a GitHub repository containing your Dockerfile.

Repository Structure

managemeals-deploy/
├── Dockerfile
└── .dockerignore

Creating the Dockerfile

Create a Dockerfile in the root of your repository:

FROM managemeals/managemeals:latest


# Environment configuration
ENV NODE_ENV=production
ENV PORT=3000


# Database configuration (using SQLite for simplicity)
ENV DATABASE_URL=file:/data/managemeals.db


# Create data directory
RUN mkdir -p /data


# Expose the web interface port
EXPOSE 3000

Alternative with PostgreSQL Support

For production deployments with PostgreSQL:

FROM managemeals/managemeals:latest


# Environment configuration
ENV NODE_ENV=production
ENV PORT=3000


# Database configuration
ENV DATABASE_URL=${DATABASE_URL}


# Secret key for sessions
ENV SECRET_KEY=${SECRET_KEY}


# Expose the application port
EXPOSE 3000

Creating the .dockerignore File

Create a .dockerignore file:

.git
.github
*.md
README.md
LICENSE
.gitignore
*.log
.DS_Store
.env
node_modules/

Environment Variables Reference

VariableRequiredDefaultDescription
DATABASE_URLYes-Database connection string
SECRET_KEYYes-Secret key for session encryption
PORTNo3000Port for the web interface
NODE_ENVNoproductionEnvironment mode

Deploying ManageMeals on Klutch.sh

Once your repository is prepared, follow these steps to deploy:

    Generate a Secret Key

    Generate a secure secret key for session management:

    Terminal window
    openssl rand -hex 32

    Save this key securely for the environment variables configuration.

    Push Your Repository to GitHub

    Initialize your repository and push to GitHub:

    Terminal window
    git init
    git add Dockerfile .dockerignore
    git commit -m "Initial ManageMeals deployment configuration"
    git remote add origin https://github.com/yourusername/managemeals-deploy.git
    git push -u origin main

    Create a New Project on Klutch.sh

    Navigate to the Klutch.sh dashboard and create a new project. Give it a descriptive name like “managemeals” or “meal-planner”.

    Create a New App

    Within your project, create a new app. Connect your GitHub account if you haven’t already, then select the repository containing your ManageMeals Dockerfile.

    Configure HTTP Traffic

    ManageMeals serves its web interface over HTTP. In the deployment settings:

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

    Set Environment Variables

    In the environment variables section, add:

    VariableValue
    SECRET_KEYYour generated secret key
    DATABASE_URLfile:/data/managemeals.db (for SQLite)

    Attach Persistent Volumes

    Persistent storage is essential for your recipes. Add volumes:

    Mount PathRecommended SizePurpose
    /data5 GBDatabase and application data
    /uploads10 GBRecipe images and attachments

    Deploy Your Application

    Click Deploy to start the build process. Klutch.sh will:

    • Detect your Dockerfile automatically
    • Build the container image
    • Attach the persistent volumes
    • Start the ManageMeals container
    • Provision an HTTPS certificate

    Access ManageMeals

    Once deployment completes, access your instance at https://your-app-name.klutch.sh.

Initial Setup and Configuration

Creating Your Account

When you first access ManageMeals:

  1. Click Sign Up or Register
  2. Create your administrator account
  3. Set up your profile and preferences

Configuring Preferences

Set up your meal planning preferences:

  1. Go to Settings or Preferences
  2. Configure:
    • Default serving sizes
    • Preferred measurement units (metric/imperial)
    • Dietary restrictions or preferences
    • Meal types (breakfast, lunch, dinner, snacks)

Managing Recipes

Adding Recipes Manually

  1. Click Add Recipe or the + button
  2. Enter recipe details:
    • Title and description
    • Prep time and cook time
    • Servings
    • Ingredients with quantities
    • Step-by-step instructions
  3. Upload a photo (optional)
  4. Add tags and categories
  5. Click Save

Importing Recipes from URLs

ManageMeals can parse recipes from many websites:

  1. Click Import or Import from URL
  2. Paste the recipe URL
  3. Review the parsed recipe data
  4. Make any necessary adjustments
  5. Save to your collection

Organizing Recipes

Keep your recipes organized:

  • Categories: Breakfast, Lunch, Dinner, Desserts, etc.
  • Tags: Vegetarian, Quick, Holiday, Family Favorite
  • Collections: Themed groups like “Summer BBQ” or “Weeknight Dinners”
  • Favorites: Mark recipes you make frequently

Meal Planning

Weekly Meal Planning

  1. Navigate to the Meal Plan or Calendar view
  2. Click on a day to add meals
  3. Select from your recipe collection
  4. Assign to meal slots (breakfast, lunch, dinner)
  5. Repeat for the entire week

Planning Tips

  • Prep Overlap: Choose recipes that share ingredients to minimize waste
  • Variety: Mix cuisines and protein types throughout the week
  • Leftovers: Plan meals that yield good leftovers for lunches
  • Busy Days: Schedule simple meals for hectic days

Templates

Create meal plan templates for common patterns:

  • Weekly rotation of family favorites
  • Healthy eating plans
  • Budget-friendly weeks

Shopping Lists

Automatic Generation

Generate shopping lists from your meal plan:

  1. Select the meals to include
  2. Click Generate Shopping List
  3. Review the consolidated ingredient list
  4. Remove items you already have
  5. Export or view on mobile

List Management

  • Check Off Items: Mark items as purchased while shopping
  • Custom Items: Add non-recipe items to the list
  • Store Sections: Organize by grocery store sections
  • Share: Send list to family members

Multi-User Features

Adding Family Members

  1. Go to Settings > Users or Family
  2. Invite family members via email
  3. Set permissions (view, edit, admin)

Shared Features

  • Shared Recipes: Access the same recipe collection
  • Collaborative Planning: Family members can add to meal plans
  • Shared Lists: Everyone can check off items while shopping

Production Best Practices

Security Recommendations

  • Strong Passwords: Use strong passwords for all accounts
  • Regular Updates: Keep the application updated
  • Backup Data: Regular backups of recipes and meal plans

Data Backup

Protect your recipe collection:

  1. Database Exports: Regular backups of the database
  2. Recipe Export: Export recipes in portable formats
  3. Image Backup: Back up uploaded images separately

Performance Tips

  • Optimize Images: Resize recipe images before uploading
  • Regular Cleanup: Remove unused or duplicate recipes
  • Archive Old Plans: Archive past meal plans to keep things organized

Troubleshooting Common Issues

Recipe Import Not Working

Symptoms: URL import fails or parses incorrectly.

Solutions:

  • Try a different recipe URL format
  • Check if the website blocks scraping
  • Import manually and copy/paste content
  • Check the URL is publicly accessible

Images Not Displaying

Symptoms: Recipe photos appear broken.

Solutions:

  • Verify the uploads volume is mounted correctly
  • Check file permissions
  • Re-upload the image
  • Use supported formats (JPEG, PNG)

Slow Performance

Symptoms: Pages load slowly.

Solutions:

  • Optimize uploaded images
  • Increase allocated resources
  • Clean up old data
  • Check database performance

Shopping List Incorrect

Symptoms: List has wrong quantities or missing items.

Solutions:

  • Review recipe ingredient formats
  • Check serving size multipliers
  • Manually adjust the generated list
  • Verify recipe data is complete

Alternative Meal Planning Applications

If ManageMeals doesn’t fit your needs, consider:

  • Mealie: Feature-rich self-hosted recipe manager
  • Tandoor Recipes: Recipe management with meal planning
  • Grocy: Household management including meal planning

Additional Resources

Conclusion

Deploying ManageMeals on Klutch.sh gives you a private, accessible platform for managing your recipes and planning meals. With automatic shopping list generation and multi-user support, you can streamline your entire meal preparation workflow.

The combination of ManageMeals’ intuitive interface and Klutch.sh’s reliable hosting means your meal planner is always available when you need it, whether you’re planning at home or checking recipes at the grocery store. Take control of your meal planning and reduce food waste with a self-hosted solution that keeps your data private.