Admidio is a free and open-source web application for managing groups and members. It's an excellent tool for organizations such as clubs, associations, and communities who aim to maintain their member's data in one place.
In this tutorial, we will guide you through the steps required to install Admidio on OpenSUSE Latest.
Before installing any software, ensure your system is up-to-date by running the following command:
sudo zypper update
To run Admidio, we need to install Apache, PHP, MySQL, and some PHP modules. Run the following command to install them all:
sudo zypper install apache2 php7 php7-mysql apache2-mod_php7 php7-gd php7-json php7-mbstring php7-zip mariadb mariadb-client
Admidio requires a MySQL database for storage. Run the following command to start the MySQL service and enable it to start at boot:
sudo systemctl enable --now mysql
We will also secure the MySQL installation by running:
sudo mysql_secure_installation
Follow the instructions and answer the prompts to secure your database server.
Now, log in to MySQL with the following command:
sudo mysql -u root -p
Note: Enter the MySQL root password you set up in the previous step.
After logging in, create a new database and a user with the following commands:
CREATE DATABASE admidio;
GRANT ALL PRIVILEGES ON admidio.* TO 'admidio_user'@'localhost' IDENTIFIED BY 'strongpassword';
FLUSH PRIVILEGES;
EXIT;
Note: Replace 'strongpassword' with a strong and unique password. Also, please take note of the password as we'll use it later in this tutorial.
Next, we'll download the Admidio package from the official website using wget:
cd /tmp
wget https://www.admidio.org/downloads/admidio/latest/admidio-X.Y.Z.zip
Note: Replace X.Y.Z with the latest Admidio version number at the time of this tutorial.
Extract the downloaded file to the Apache document root directory with the following commands:
sudo unzip admidio*.zip -d /srv/www/htdocs/admidio/
sudo chown -R wwwrun:www /srv/www/htdocs/admidio/
Before we can access Admidio from the browser, we need to configure it. First, rename the configuration file by running the command:
sudo mv /srv/www/htdocs/admidio/include/adm_my_config.inc.example /srv/www/htdocs/admidio/include/adm_my_config.inc
Open the adm_my_config.inc
file with a text editor, and set the following database variables.
$g_adm_srv = "localhost";
$g_adm_db = "admidio";
$g_adm_usr = "admidio_user";
$g_adm_pwd = "strongpassword";
Note: Replace strongpassword
with the password you set up earlier in this tutorial.
Create the admidio.conf
file in the Apache configuration directory by running the following command:
sudo nano /etc/apache2/conf.d/admidio.conf
Add the following lines and save the file:
Alias /admidio "/srv/www/htdocs/admidio"
<Directory "/srv/www/htdocs/admidio">
Options +FollowSymLinks
AllowOverride All
Require all granted
</Directory>
Restart Apache for the changes to take effect by running:
sudo systemctl restart apache2
Finally, we can now access Admidio from a web browser. Open your preferred browser and navigate to http://localhost/admidio
.
You will be prompted to set up a new admin account during the first login.
Congratulations, you have successfully installed Admidio on OpenSUSE Latest!
If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!
Alternatively, for the best virtual desktop, try Shells!