How to Install Juntagrico on OpenSUSE Latest

Juntagrico is a Swiss-based open-source platform for managing community-supported agriculture (CSA) projects. It allows farmers to collaborate with their customers and automate most of the administrative tasks involved in running a CSA.

If you're running OpenSUSE Latest and want to install Juntagrico on your system, this tutorial will guide you through the process step-by-step.

Prerequisites

Before you begin, you need to make sure your system meets the following requirements:

  • OpenSUSE Latest
  • Apache web server
  • MySQL or MariaDB database server
  • PHP version 7.4 or higher (with the following extensions: mysqli, pdo_mysql, intl, json, mbstring, ctype, xml)
  • Git

Step 1: Install Apache server

To install Apache server on your OpenSUSE system, run the following command:

sudo zypper install apache2

After the installation is complete, start and enable Apache server with these commands:

sudo systemctl start apache2
sudo systemctl enable apache2

Verify that Apache server is running by accessing your system's IP address in a web browser. You should see the Apache default page.

Step 2: Install MySQL or MariaDB server

To install MySQL or MariaDB server on your OpenSUSE system, run the following command:

sudo zypper install mariadb mariadb-client

After the installation is complete, run this command to secure the installation:

sudo mysql_secure_installation

Follow the prompts to set a root password, remove anonymous users, disallow root login remotely, and remove the test database.

Start and enable MySQL or MariaDB server with these commands:

sudo systemctl start mariadb
sudo systemctl enable mariadb

Verify that the MySQL or MariaDB server is running by running the following command:

sudo systemctl status mariadb

Step 3: Install PHP and required extensions

To install PHP and the required extensions on your OpenSUSE system, run the following command:

sudo zypper install apache2-mod_php7 php7-mysqli php7-pdo_mysql php7-intl php7-json php7-mbstring php7-ctype php7-xml

After the installation is complete, restart Apache server with this command:

sudo systemctl restart apache2

Step 4: Install Git

To install Git on your OpenSUSE system, run the following command:

sudo zypper install git

Step 5: Clone Juntagrico repository

To clone Juntagrico repository on your OpenSUSE system, run the following command:

sudo git clone https://github.com/juntagrico/juntagrico.git /srv/www/htdocs/juntagrico

Change the ownership of the cloned directory to Apache user with this command:

sudo chown -R wwwrun:www /srv/www/htdocs/juntagrico

Step 6: Create MySQL or MariaDB database and user

Log in to the MySQL or MariaDB server as root with this command:

sudo mysql -u root -p

Create a new database for Juntagrico:

CREATE DATABASE juntagrico;

Create a new user for Juntagrico:

CREATE USER 'juntagrico'@'localhost' IDENTIFIED BY 'your_password_here';

Grant the user permissions to the database:

GRANT ALL PRIVILEGES ON juntagrico.* TO 'juntagrico'@'localhost';

Flush the privileges and exit the MySQL or MariaDB server:

FLUSH PRIVILEGES;
EXIT;

Step 7: Configure Juntagrico

Copy the config.dist.php to config.php file:

cd /srv/www/htdocs/juntagrico/
sudo cp config.dist.php config.php

Edit the config.php file with your favorite text editor:

sudo nano config.php

Change the following lines to reflect your MySQL or MariaDB database and user credentials:

const DB_HOST = 'localhost';
const DB_NAME = 'juntagrico';
const DB_USER = 'juntagrico';
const DB_PASSWORD = 'your_password_here';

Save and exit the file.

Step 8: Install Juntagrico dependencies

Install Juntagrico dependencies with this command:

cd /srv/www/htdocs/juntagrico/
sudo ./composer.phar install

Note: If you get an error message about php7-posix extension missing, you can install it with this command:

sudo zypper install php7-posix

Step 9: Initialize Juntagrico

Initialize Juntagrico with this command:

cd /srv/www/htdocs/juntagrico/
sudo php7.4 init.php

Step 10: Test Juntagrico

Open your web browser and access your system's IP address followed by /juntagrico/. You should see the Juntagrico installation wizard.

Follow the wizard steps to finish the installation process.

Congratulations, you have successfully installed Juntagrico on your OpenSUSE system!