How to Install KitchenOwl on Debian Latest

KitchenOwl is a recipe management system that helps you plan your meals, create shopping lists, and discover new recipes. In this tutorial, we will show you how to install KitchenOwl on the latest Debian distribution.

Prerequisites

A Debian Latest server with root access
Basic command line knowledge

Step 1: Install Required Dependencies

Before installing KitchenOwl, there are a few dependencies that need to be installed. Open the terminal on your Debian server and enter the following command to install the necessary packages:

sudo apt update && sudo apt install git python3 python3-pip python3-venv python3-dev libpq-dev postgresql

This command will install Git, Python 3, pip, and several additional libraries and tools needed for KitchenOwl.

Step 2: Clone the KitchenOwl Repository

The next step is to clone KitchenOwl's official repository from GitHub. Enter the following command in your terminal:

git clone https://github.com/tombursch/kitchenowl.git

This command will clone the repository to a kitchenowl directory in your current working directory.

Step 3: Create a Virtual Environment

Creating a virtual environment is recommended to manage the dependencies required by KitchenOwl. In the terminal, navigate to the kitchenowl directory and enter the following command:

python3 -m venv env

This command will create a virtual environment named env in the kitchenowl directory.

Step 4: Activate the Virtual Environment

To activate the virtual environment, enter the following command in the terminal:

source env/bin/activate

This command will activate the virtual environment, and you'll notice that the terminal prompt has changed to reflect the name of the environment.

Step 5: Install Required Python Packages

In the activated virtual environment, enter the following command to install the required Python packages:

pip3 install -r requirements.txt

This command will install all the dependencies that KitchenOwl requires.

Step 6: Configure the Database

Next, we need to configure the database for KitchenOwl. The easiest way to do this is to create a new PostgreSQL database and user. To do this, enter the following commands in the terminal:

sudo -u postgres psql

This command will log you into the PostgreSQL server. In the postgres prompt, enter the following:

CREATE DATABASE kitchenowl;
CREATE USER kitchenowluser WITH PASSWORD 'your-password';
GRANT ALL PRIVILEGES ON DATABASE kitchenowl TO kitchenowluser;

In the above command, replace your-password with your desired password.

Step 7: Create the Configuration File

To run KitchenOwl, we need to create a configuration file. In the kitchenowl directory, rename the example.config.yaml file to config.yaml:

mv example.config.yaml config.yaml

Edit the newly created config.yaml file and update the database information with the username, password, and database name.

postgres:
  user: kitchenowluser
  password: your-password
  host: localhost
  dbname: kitchenowl
  port: 5432

Save and close the file.

Step 8: Run KitchenOwl

Finally, it's time to run KitchenOwl. In the activated virtual environment, enter the following command:

python3 app.py

This command will run the Flask development server, and you'll see output similar to the following:

 * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

Open your web browser and navigate to http://127.0.0.1:5000. You should see KitchenOwl's login page.

Conclusion

In this tutorial, we showed you how to install KitchenOwl on Debian Latest. Now you can start exploring KitchenOwl and managing your recipes like a pro!