Fixing "Home Directory Not Available - Aborting" Error

Contents: What is the Error? Verify If the Home Directory Exists Recreate the Home Directory Check and Fix File Ownership Verify SSH Configuration Ensure User Account is Not Locked Check Disk Space Restart the System Summary of Fixes

Fix Home Directory Not Available Aborting error

What is the Error?

The "Home Directory Not Available - Aborting" error occurs when a user attempts to log in (via SSH, FTP, or a web application), but their home directory is missing, incorrectly set, or has incorrect permissions. This can happen due to:

A deleted or misconfigured home directory.
Incorrect user settings in /etc/passwd.
File permission or ownership issues.

Here's how a system administrator can troubleshoot and resolve the problem.

Verify If the Home Directory Exists

The first step is to check whether the home directory is missing.

Check the User's Home Directory in /etc/passwd

Run the following command to check the user's home directory:

grep username /etc/passwd

Example output:

username:x:1001:1001::/home/username:/bin/bash

The 6th field (/home/username) specifies the user's home directory.
The 7th field (/bin/bash) specifies the shell.

Check if the Directory Exists

Run:

ls -ld /home/username

If the directory does not exist, you will see an error like:

ls: cannot access '/home/username': No such file or directory

If the directory is missing, proceed to Step 2.

Recreate the Home Directory

If the home directory is missing, create it manually.

Create the Directory and Set Permissions

sudo mkdir -p /home/username sudo chown username:username /home/username sudo chmod 700 /home/username

mkdir -p /home/username: Creates the directory if it does not exist.
chown username:username /home/username: Sets the correct ownership.
chmod 700 /home/username: Ensures only the user has access.

Copy Default Files to the Home Directory

To restore default user files, copy them from /etc/skel/:

cp -r /etc/skel/. /home/username/

Note: Now, try logging in again.

Check and Fix File Ownership

If the home directory exists but the user still cannot log in, verify ownership and permissions.

Check Home Directory Ownership

ls -ld /home/username

Example output:

drwx------ 2 root root 4096 Feb 10 12:00 /home/username

If the owner is root instead of the user, fix it:

sudo chown username:username /home/username

Ensure Correct Permissions

sudo chmod 700 /home/username

Verify SSH Configuration (If Issue Occurs During SSH Login)

If this error occurs when logging in via SSH, check /etc/ssh/sshd_config to ensure UsePAM is enabled.

Edit SSH Configuration

sudo nano /etc/ssh/sshd_config

Look for the following settings and ensure they are correctly configured:

UsePAM yes PermitRootLogin no

Then restart SSH:

sudo systemctl restart sshd

Ensure User Account is Not Locked

Check if the user account is locked:

sudo passwd -S username

If the output shows "locked", unlock it:

sudo passwd -u username

Check Disk Space

If the disk is full, users may be unable to log in or access their home directories.

Check Disk Usage

df -h

If /home or / is 100% full, clear unnecessary files.

Restart the System (If Necessary)

If everything appears correct but the issue persists, restart the server:

sudo reboot

Summary of Fixes

Step	Action
1	Verify home directory with `grep username /etc/passwd`
2	Create the home directory using `mkdir -p /home/username`
3	Check ownership with `ls -ld /home/username` and fix with `chown`
4	Verify SSH settings and restart SSH
5	Ensure the account is not locked with `passwd -S username`
6	Check disk space with `df -h`
7	Restart the server if needed

By following these steps, you can resolve the "Home Directory Not Available - Aborting" error and restore user access.

Fixing "Home Directory Not Available - Aborting" Error

What is the Error?

Verify If the Home Directory Exists

Check the User's Home Directory in /etc/passwd

Example output:

Check if the Directory Exists

Recreate the Home Directory

Create the Directory and Set Permissions

Copy Default Files to the Home Directory

Check and Fix File Ownership

Check Home Directory Ownership

Example output:

Ensure Correct Permissions

Verify SSH Configuration (If Issue Occurs During SSH Login)

Edit SSH Configuration

Ensure User Account is Not Locked

Check Disk Space

Check Disk Usage

Restart the System (If Necessary)

Summary of Fixes

Hosting

Cloud Solution

For You

VDS

Website Builders

Our services

Client Area

Select Currency

Fixing "Home Directory Not Available - Aborting" Error

What is the Error?

Verify If the Home Directory Exists

Check the User's Home Directory in /etc/passwd

Example output:

Check if the Directory Exists

Recreate the Home Directory

Create the Directory and Set Permissions

Copy Default Files to the Home Directory

Check and Fix File Ownership

Check Home Directory Ownership

Example output:

Ensure Correct Permissions

Verify SSH Configuration (If Issue Occurs During SSH Login)

Edit SSH Configuration

Ensure User Account is Not Locked

Check Disk Space

Check Disk Usage

Restart the System (If Necessary)

Summary of Fixes

Hosting

Cloud Solution

For You

VDS

Website Builders

Our services

Client Area

Выберите валюту