Deploying Recipya

Introduction

Recipya is a clean, simple, and self-hosted recipe manager built with Go. Featuring a minimalist design and straightforward functionality, Recipya focuses on the essentials of recipe management without unnecessary complexity.

Key features of Recipya include:

• Clean Interface: Minimalist design focused on recipes
• Recipe Import: Import from URLs using automatic extraction
• Multi-Format Support: Import from JSON, PDF, and other formats
• Categories: Organize recipes by category
• Search: Full-text search across recipes
• Print View: Printer-friendly recipe format
• Export: Export recipes for backup or sharing
• Multi-User: Support for multiple accounts
• Lightweight: Single binary with minimal dependencies
• Fast: Built with Go for excellent performance

This guide walks through deploying Recipya on Klutch.sh using Docker and setting up your recipe collection.

Prerequisites

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

• A Klutch.sh account
• A GitHub account with a repository for your Recipya configuration
• Basic familiarity with Docker

Deploying Recipya on Klutch.sh

Create Your Dockerfile

Create a Dockerfile in your repository:

FROM ghcr.io/reaper47/recipya:latest

# Environment configuration
ENV RECIPYA_SERVER_PORT=8080

# Expose the web interface
EXPOSE 8080

# Volume for data persistence
VOLUME /data

Push Your Repository to GitHub

Commit and push your Dockerfile to your GitHub repository.

Create a New Project on Klutch.sh

Navigate to the Klutch.sh dashboard and create a new project named “recipya”.

Create a New App

Create a new app within your project and connect your GitHub repository.

Configure HTTP Traffic

In the deployment settings:

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

Set Environment Variables

Configure the following environment variables:

Variable	Value
RECIPYA_SERVER_PORT	8080
RECIPYA_SERVER_URL	https://your-app-name.klutch.sh
RECIPYA_EMAIL	Admin email (optional, for notifications)

Attach Persistent Volumes

Add persistent storage:

Mount Path	Recommended Size	Purpose
/data	10 GB	Database and recipe images

Deploy Your Application

Click Deploy to build and start your Recipya instance.

Access Recipya

Once deployment completes, access your instance at https://your-app-name.klutch.sh. Create your account on first visit.

Using Recipya

Adding Recipes

Import from URL:

1. Click the ”+” button
2. Select “Import from URL”
3. Paste the recipe page URL
4. Recipya extracts and saves the recipe

Manual Entry:

1. Click the ”+” button
2. Select “Manual Entry”
3. Fill in recipe details
4. Add ingredients and instructions
5. Save the recipe

Organizing Recipes

• Categories: Assign recipes to categories
• Search: Use the search bar to find recipes
• Favorites: Mark frequently used recipes

Importing Existing Collections

Recipya can import recipes from:

• Other recipe managers (JSON export)
• PDF cookbooks
• Recipe websites (batch import)

Additional Resources

• Recipya Demo
• Recipya GitHub Repository
• Recipya Documentation
• Klutch.sh Persistent Volumes

Conclusion

Deploying Recipya on Klutch.sh provides a clean, simple recipe manager with automatic builds, persistent storage, and secure HTTPS access. Keep your recipe collection organized with a minimalist interface that focuses on what matters most - your recipes.