Thursday, November 14, 2024

Installing Admidio on Debian/Ubuntu

Mahesh Palamuttath November 14, 2024

Admidio is a free, open-source membership management system ideal for clubs, organizations, and groups looking to manage their members efficiently. This guide will walk you through the steps to install Admidio on a Debian or Ubuntu server.

Prerequisites

A server running Debian 12 or Ubuntu.
Apache, MariaDB, and PHP installed.

Step 1: Update Your System

First, update your packages to the latest versions:

sudo apt update && sudo apt upgrade -y

Step 2: Install Apache, MariaDB, and PHP

Admidio requires a LAMP stack. Use the following command to install it:

sudo apt install apache2 mariadb-server php libapache2-mod-php php-mysql php-curl php-xml php-zip php-gd php-mbstring -y

Step 3: Configure MariaDB

Secure your MariaDB installation and create a database for Admidio:

sudo mysql_secure_installation

sudo mysql -u root -p

Then, execute the following SQL commands to set up the database:

CREATE DATABASE admidio;

CREATE USER 'admidio_user'@'localhost' IDENTIFIED BY 'your_password';

GRANT ALL PRIVILEGES ON admidio.* TO 'admidio_user'@'localhost';

FLUSH PRIVILEGES;

EXIT;

Replace 'your_password' with a strong password.

Step 4: Download and Install Admidio

Navigate to the web root directory and download Admidio:

cd /var/www/html

wget https://excellmedia.dl.sourceforge.net/project/admidio/Admidio/4.3.x/admidio-4.3.11.zip

sudo apt install unzip -y

sudo unzip Admidio-4.3.11.zip -d admidio

Set the correct permissions:

sudo chown -R www-data:www-data /var/www/html/admidio

sudo chmod -R 755 /var/www/html/admidio

Step 5: Configure Apache

Create a new Apache configuration file for Admidio:

sudo nano /etc/apache2/sites-available/admidio.conf

Add the following configuration:

<VirtualHost *:80>

ServerAdmin admin@example.com

DocumentRoot /var/www/html/admidio

ServerName your-domain.com

<Directory /var/www/html/admidio>

Options Indexes FollowSymLinks

AllowOverride All

Require all granted

</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log

CustomLog ${APACHE_LOG_DIR}/access.log combined

</VirtualHost>

Replace your-domain.com with your domain or server IP.

Enable the new site and the rewrite module:

sudo a2ensite admidio.conf

sudo a2enmod rewrite

sudo systemctl restart apache2

Step 6: Complete the Installation via Web Browser

Open your browser and navigate to http://your-domain.com/admidio. Follow the installation wizard, enter your database details, and configure your admin account.

Step 7: Post-Installation

Remove the installer: For security reasons, delete the installer folder:

sudo rm -rf /var/www/html/admidio/installer

Enable SSL (Optional but recommended): Use Certbot to secure your site:

sudo apt install certbot python3-certbot-apache -y

sudo certbot --apache -d your-domain.com