How to install Hubzilla on Ubuntu 24.04

Looking to set up your own decentralized social media hub? Hubzilla is one of the best choices for this! With it, you can take control of your online presence while fostering interactive communities.

In this guide, we’ll walk you through the process of installing and configuring Hubzilla on Ubuntu 24.04. Don’t worry if you’re not a tech whiz; we’ll break down each step to make it accessible for all skill levels.

Ubuntu 24.04 is perfectly suited for this task, offering stability and security for your Hubzilla installation. So, whether you want to create a personal platform or a collaborative space, you’ll find everything you need right here.

Ready to get started? Let’s dive into the details and set you up with a unique social media experience that’s entirely in your hands.

Installing Prerequisites for Hubzilla on Ubuntu 24.04

Before we dive into installing Hubzilla, let’s get your system prepped with the necessary prerequisites. This involves installing a few essential packages and services that Hubzilla depends on.

First, ensure your system is up to date. Open your terminal and run:

sudo apt update && sudo apt upgrade -y

Now, you’ll need to install Apache, PHP, and MariaDB, which are critical for running Hubzilla. Execute the following command:

sudo apt install apache2 mariadb-server mariadb-client php php-cli php-mysql php-gd php-xml php-mbstring unzip wget -y

After installation, it’s a good idea to enable and start these services to ensure they’re running smoothly:

sudo systemctl enable apache2 mariadb

sudo systemctl start apache2 mariadb

Finally, you’ll want to secure your MariaDB installation. Use the command below and follow the prompts:

sudo mysql_secure_installation

With everything set up, your system is now ready to host Hubzilla. Next up, we’ll install Hubzilla itself and get it configured. Stick around; we’re almost there!

Downloading and Setting Up Hubzilla

With your system prepared, it’s time to download and set up Hubzilla. This part of the process is straightforward, so let’s tackle it step by step.

Start by navigating to the web directory where you’ll install Hubzilla. Open your terminal and run:

cd /var/www/

Next, download the latest version of Hubzilla using git. If git isn’t installed, you can add it by running sudo apt install git. Afterward, clone the Hubzilla repository:

sudo git clone https://framagit.org/hubzilla/core.git hubzilla

Once downloaded, you’ll need to set the correct permissions to ensure Hubzilla can function properly. Enter these commands:

sudo chown -R www-data:www-data hubzilla

sudo chmod -R 755 hubzilla

Now, create a configuration file for Apache to enable Hubzilla’s site. Here’s a simple way to do it:

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

In the editor, add the following configuration, then save and close:

<VirtualHost *:80>

    ServerAdmin admin@example.com

    DocumentRoot /var/www/hubzilla/

    ServerName your_domain_or_IP

    <Directory /var/www/hubzilla/>

        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_or_IP with your actual domain name or IP address.

Enable the site and the rewrite module, then reload Apache:

sudo a2ensite hubzilla.conf

sudo a2enmod rewrite

sudo systemctl reload apache2

You’ve successfully downloaded and set up the framework for Hubzilla. Next, we’ll move on to configuring and finalizing your installation. Almost there!

Database Configuration for Hubzilla

Now that Hubzilla is set up, let’s configure the database—a crucial step to get everything working smoothly. We’ll guide you through creating a database and setting up user permissions to ensure everything functions seamlessly.

Creating a Database and User

First, you’re going to create a new database for Hubzilla. Open your terminal and access the MariaDB shell:

sudo mysql -u root -p

After entering your password, create a new database. Here, we’ll name it hubzilla_db:

CREATE DATABASE hubzilla_db;

Next, create a new user dedicated to interacting with this database. Replace hubzilla_user and password with your desired username and a strong password:

CREATE USER 'hubzilla_user'@'localhost' IDENTIFIED BY 'password';

Configuring Database Permissions

To ensure Hubzilla can operate efficiently, grant the user full permissions on the newly created database:

GRANT ALL PRIVILEGES ON hubzilla_db.* TO 'hubzilla_user'@'localhost';

Apply these changes by flushing the privileges:

FLUSH PRIVILEGES;

Finally, exit the MariaDB shell:

EXIT;

Your database is now configured and linked to your Hubzilla installation. With the hard setup work behind us, we’re ready to move on to final configuration and launch!

Configuring Hubzilla on the Web Server

With the database ready, it’s time for the exciting part: setting up Hubzilla through the web interface. Let’s bring your digital hub to life.

Start by opening a web browser and entering your server’s domain name or IP address. You should see the Hubzilla installation page. If it doesn’t appear, double-check your Apache configuration and ensure Apache is running.

On the setup page, Hubzilla will run through a checklist to ensure your server meets all the requirements. If any items are flagged, you may need to adjust your server settings accordingly.

Next, you’ll be prompted to enter your database details. Use the database name, user, and password you created earlier:

Database Type: Choose MySQL/MariaDB.
Database Name: hubzilla_db
Database Username: hubzilla_user
Password: Your chosen password

Proceed through the remaining installation steps. This is where you can configure your site settings, such as the site name and admin email address. These can usually be adjusted later, but it’s nice to start with the right details.

Once completed, the setup script will finalize your configuration. You’ll gain access to your new Hubzilla platform! Now, you’re all set to explore and expand your very own decentralized network. Enjoy the journey!

Conclusion

Congratulations on successfully installing and configuring Hubzilla on Ubuntu 24.04! You’ve taken a significant step toward hosting your own decentralized social network, giving you unprecedented control over your digital presence.

With your new Hubzilla server up and running, you can start exploring its powerful features. Whether you’re setting up personal channels, connecting with others on the Zot network, or customizing your site, the possibilities are vast and exciting.

Remember, this is just the beginning. Hubzilla’s flexibility allows you to continuously expand your platform, integrate new features, and even connect with other platforms. Dive in, explore, and make your space truly your own.

Don’t forget to regularly back up your data and keep your system updated for security and performance. Feel free to reach out to the vibrant Hubzilla community if you have questions or need more inspiration.

Your adventure in the realm of decentralized networking has only just begun. Enjoy the journey, and welcome to the Hubzilla community!