Fixing "421 Home Directory Not Available – Aborting" Error: A Complete Step-by-Step Guide

Checking If the Home Directory Exists

Before recreating the home directory, let's confirm whether it is missing.

Find the User's Home Directory

1. Open a terminal and run:
   grep username /etc/passwd

   Replace username with the actual username.

2. Example output:
   username:x:1001:1001::/home/username:/bin/bash
   • The 6th field (/home/username) is the user's home directory.
   • The 7th field (/bin/bash) is the default shell.
3. If you see something like this:
   username:x:1001:1001::/nonexistent:/bin/bash

   It means the home directory is set to /nonexistent, and the system cannot find it.

Verify If the Directory Exists

Run:

Expected Output (If Exists)

• The first part (drwx------) shows directory permissions.
• The second and third parts (username username) indicate ownership.

If the directory is missing, you will see:

In this case, proceed to Step 3 to recreate it.

Recreating the Home Directory

If the home directory is missing, we need to recreate it.

Create the Home Directory

Run:

The -p flag ensures the command does not fail if the directory already exists.

Set Correct Ownership

After creating the home directory, set its ownership to the correct user:

chown username:username sets ownership so the user can access it.

Run:

You should see:

Set Correct Permissions

Permissions must be at least 700 for private access or 755 for public access.

• For private directories (Recommended for SSH/FTP users):
  sudo chmod 700 /home/username
• For shared access (if other users need to access files):
  sudo chmod 755 /home/username

Copy Default Files

If the home directory was deleted, the user may also be missing essential files like .bashrc, .profile.

Run:

This copies default system files for a better user experience.

Verify and Fix Configuration Files

If the home directory exists but the error persists, check system settings.

Ensure /etc/passwd Points to the Correct Home Directory

1. Open the user configuration:
   sudo nano /etc/passwd
2. Find the line for your user:
   username:x:1001:1001::/nonexistent:/bin/bash
3. If the home directory is set to /nonexistent, change it to /home/username:
   username:x:1001:1001::/home/username:/bin/bash
4. Save and exit (CTRL+X, Y, Enter).

Restart Services

If using FTP, restart the FTP service:

If using SSH, restart the SSH service:

Additional Fixes

If the issue persists, consider these additional checks:

Check Disk Space

If the home directory exists but is inaccessible, check for low disk space:

If /home or / is full, delete unnecessary files.

Ensure SELinux Is Not Blocking Access (CentOS/RHEL)

If SELinux is enabled, it might block access to /home.

Run:

Then restart the system.

Check User Quotas

If quotas are enabled, check if the user has exceeded their disk quota:

If necessary, increase the quota.