Skip to content

How to Configure Apache mod_userdir for User Websites

DodaTech Updated 2026-06-24 1 min read

mod_userdir enables personal websites for system users. Proper directory permissions and security restrictions prevent unauthorized access. This guide walks through the specific troubleshooting steps to diagnose and resolve user directory issues.

Before You Begin

Before you begin, be sure to have the following in place:

  • A Linux server with the relevant software installed
  • Access to the command line interface
  • Appropriate permissions (root or sudo)

Quick Fix

Wrong

mod_userdir disabled (users cannot have personal websites)

Wrong: User directories not available

UserDir enabled\nUserDir public_html\nUserDir disabled root

Right: UserDir with public_html and root disabled

Output

mod_userdir enabled\nDirectory: ~user/public_html\nDisabled: root\nAccess: http://host/~username/

Prevention

To avoid future issues, follow these best practices:

  • Enable mod_userdir with a2enmod userdir
  • Set UserDir to the directory name inside user home (default: public_html)
  • Disable userdir for system users like root
  • Set permissions for the public_html path
  • Create the public_html directory with proper permissions

DodaTech Tools

For further assistance with any of the above issues, consider using DodaTech consulting services or DodaTech tutorials for more in-depth guidance.

Common Mistakes with mod userdir

  1. Using foldl instead of foldl' causing stack overflow on large lists
  2. Forgetting deriving (Show, Eq) on custom data types needed for debugging
  3. Placing the wildcard pattern first in case expressions, making all subsequent patterns unreachable

These mistakes appear frequently in real-world APACHE code. DodaTech's contributors have identified these patterns through analysis of open-source projects and production systems.

Practice Exercise

Write a pure function that safely divides two integers using Maybe, then test it with edge cases like division by zero and negative numbers.

This exercise reinforces the concepts covered in this guide. Try implementing it before checking online solutions.

FAQ

What URL format does mod_userdir use?|||http://host/~username/ maps to /home/username/public_html/ (or the configured UserDir directory).
What permissions are needed for userdir? The public_html directory needs o+x (execute) and files need o+r (read) permissions for Apache to serve them.

Built by the developers of DodaTech

Doda Browser, DodaZIP & Durga Antivirus Pro