Enabling User Directories

Introduction

Imagine you are managing a university server. You want every student to have their own personal website, accessible via a URL like university.com/~student1.

Instead of placing all files into one central directory, Apache provides a feature called user directories. This allows each user to host a website directly from their own home folder, typically in a subdirectory named public_html.

This feature is less common in large modern production platforms, but it remains valuable for teaching how URL mapping, permissions, and per-user web content work together.

In this lab, you will:

1. Enable the Module: Turn on the userdir feature in Apache.
2. Create the Directory: Set up the public_html folder in your home directory.
3. Configure Permissions: Ensure Apache has the right permissions to access your files.
4. Test: Access your personal page via a browser request.

Enable the Userdir Module

Apache is a modular server, meaning you can enable or disable specific features as needed. The userdir module handles the mapping of URLs like ~username to the user's home directory.

This modular design is one of Apache's defining characteristics. Many features are not always active by default; instead, administrators enable the modules they need for a particular server role.

Check the status of Apache to ensure it is running:

sudo service apache2 status

Enable the userdir module using the a2enmod (Apache 2 Enable Module) command:

The a2enmod helper is part of Ubuntu's Apache packaging conventions. It simplifies module management by creating the right symlinks instead of making you edit everything manually.

sudo a2enmod userdir

You should see a message indicating the module is being enabled.

To confirm, list the enabled modules:

ls /etc/apache2/mods-enabled/ | grep userdir

You should see userdir.conf and userdir.load, confirming the module is active.

Set Up the Web Directory

The userdir module looks for a folder named public_html inside the user's home directory. In this lab, your username is labex.

Navigate to your home directory:

cd ~

Create the public_html directory:

mkdir ~/public_html

Create a simple index.html file inside this directory to test your site:

echo "<h1>My Personal Page</h1><p>Welcome to the labex user directory.</p>" > ~/public_html/index.html

Next, we must address permissions. By default, user home directories are often private, preventing the Apache user (www-data) from entering them. Apache needs execute (x) permission on your home directory to access the public_html folder inside it.

This is a good example of web serving depending on normal Linux filesystem permissions. Apache can only serve files it is allowed to traverse and read.

Change the permissions of your home directory:

chmod 711 /home/labex

• 711 (rwx--x--x) gives you full control, while allowing others (like Apache) to traverse the directory (execute) but not list its contents (read).

That distinction between read and execute on directories is subtle but important. Execute on a directory means "you may enter or traverse it," while read means "you may list its contents."

Verify the permissions:

ls -ld /home/labex

You should see permissions ending in x, indicating traversal is allowed.

Restart the Service

After enabling a module or changing configuration, you must restart Apache for the changes to take effect.

Restart the Apache service:

sudo service apache2 restart

Verify that Apache restarted successfully:

sudo service apache2 status

The status should be active (running).

Verify the Configuration

Now that everything is set up, let's test your personal web page.

The URL format is http://server_address/~username/. Since we are on the server itself, we will use localhost.

Use curl to fetch the page:

curl http://localhost/~labex/

You should see the HTML content you created:

<h1>My Personal Page</h1>
<p>Welcome to the labex user directory.</p>

If you see a 403 Forbidden error, double-check the permissions on your home directory (/home/labex) and the public_html directory.

Summary

In this lab, you successfully configured personal web directories. You learned how to:

• Enable the Apache userdir module.
• Create and populate the public_html directory.
• Configure directory permissions to allow Apache access while maintaining security.
• Verify the setup by accessing the user-specific URL.

This feature is widely used in educational and shared hosting environments to give users their own web space.