How to Install Tania on macOS

Tania is an open-source farming management system that helps farmers and growers manage their crops, track activities, and make data-driven decisions. In this tutorial, we will walk through the steps to install Tania on macOS.

Prerequisites

Before we start the installation process, make sure you have the following requirements:

  • A macOS-based computer
  • An internet connection
  • Docker installed on your machine

If you don't have Docker installed, you can download and install it from the Docker website.

Step 1: Clone the repository

Open the terminal on your Mac and navigate to the directory where you want to install Tania. Then, type the following command to clone the Tania repository:

git clone https://github.com/Tanibox/tania-core.git

This will download all the necessary files and folders into the directory you're in.

Step 2: Create a .env file

Navigate to the tania-core directory and create a .env file by typing the following command:

cp .env.example .env

This will create a copy of the .env.example file and rename it to .env.

Step 3: Configure the .env file

Open the .env file in your preferred text editor and add the following values:

APP_URL=http://localhost
APP_PORT=8888
DB_USERNAME=tania
DB_PASSWORD=password
DB_DATABASE=tania
DB_HOST=db
DB_PORT=3306

Save the changes to the .env file.

Step 4: Start the Tania containers

Open the terminal and navigate to the tania-core directory. Then, type the following command to start the Tania containers:

docker-compose up -d

This will start the containers in detached mode, which means they will run in the background.

Step 5: Access Tania in your browser

Open your web browser and navigate to http://localhost:8888. You should see the Tania login page.

Use the default username and password to login:

  • Username: admin
  • Password: password

Congratulations! You have successfully installed Tania on your macOS-based computer.

Step 6: Stop the Tania containers

To stop the Tania containers, open the terminal and navigate to the tania-core directory. Then, type the following command:

docker-compose down

This will stop and remove the containers from your system.

Conclusion

In this tutorial, we learned how to install Tania on macOS. Tania provides an easy-to-use interface for managing crops and activities on your farm or garden. We hope this tutorial helped you get started with Tania.