1. Introduction

When it comes to setting up an FTP server on Linux, the Very Secure FTP Daemon (vsftpd) is often the go-to choice for us as system administrators due to its reputation for security and performance. However, even with its robust design, configuring vsftpd can sometimes lead to challenges, particularly when it fails to read its configuration file, which is a critical component for its operation.

In this tutorial, we’ll explore how to troubleshoot and resolve issues related to vsftpd’s inability to read its config file. We’ll walk through several basic and advanced scenarios that could cause this problem and provide step-by-step solutions to get our FTP service up and running smoothly again. Let’s get started!

2. Understanding the Error

A typical scenario where we might encounter an issue with vsftpd involves an error message during the service startup process.

For example, when we check the status of the vsftpd service with systemctl, we can see something similar to:

$ sudo systemctl status vsftpd
vsftpd.service - vsftpd FTP server
Loaded: loaded (/lib/systemd/system/vsftpd.service; enabled; vendor preset: enabled)
Active: failed (Result: exit-code) since Fri 2015-10-09 19:18:50 IST; 3min 11s ago
Process: 2981 ExecStart=/usr/sbin/vsftpd /etc/vsftpd.conf (code exited, status=2)

Here, the status=2 generally points to an INVALIDARGUMENT, indicating that vsftpd has rejected one or more settings within the config file. This could be due to syntax errors, incorrect file paths, unsupported parameters, or permission issues with the file itself.

Basically, understanding this error is the first step in diagnosing the problem. It tells us that vsftpd is not just having trouble reading the config file because it’s missing or inaccessible, but that something within the file does not meet the daemon’s requirements or expectations.

3. Initial Checks and Common Fixes

Before we go deeper into troubleshooting, we should perform some initial checks to ensure we meet the basic requirements for a properly functioning vsftpd setup.

Let’s briefly see some key configurations.

3.1. Verifying the Existence and Permissions of the Configuration File

First, we should ensure that the /etc/vsftpd.conf file exists and has the correct permissions. The file should also be readable by the root user, as vsftpd typically runs as root.

To confirm this, we can use the ls command:

$ ls -l /etc/vsftpd.conf
-rw-r--r-- 1 root root 5320 Oct 9 18:00 /etc/vsftpd.conf

Our output indicates that the owner is root, and the permissions allow for reading. rw- indicates that the owner has read and write permissions; r– indicates that the group and others have read permissions. Also, the first root is the file’s owner, and the second root is the group that owns the file.

However, if the file’s owner isn’t root or it lacks the necessary permissions, we’ll have to correct it with chown and chmod:

# To change the ownership to root (user and group)
$ sudo chown root:root /etc/vsftpd.conf
# To set the proper permissions (read and write for owner, read for everyone else)
$ sudo chmod 644 /etc/vsftpd.conf

These commands should set the appropriate permissions and ownership.

3.2. Checking for Common Configuration Mistakes

We should ensure we correctly format all boolean settings (e.g., YES or NO) without any trailing comments on the same line, which can cause parsing errors.

For instance, a common mistake might look like this:

listen_ipv6=YES  # This is incorrect

Instead, we should ensure that comments are on separate lines:

# Above setting is adjusted for IPv6 compatibility

With this, there should be no formatting issue.

3.3. Conflicting Settings

The listen and listen_ipv6 directives in the vsftpd configuration file define how the server listens for incoming connections. However, misusing them can lead to conflicts and prevent the server from starting correctly.

If both listen=YES and listen_ipv6=YES are set, it can lead to conflicts depending on our network setup.

Therefore, we should try setting only one of these options based on our network configuration.

If we prefer IPv4 only:


Alternatively, we might want to stick with IPv4 and IPv6:


When we set listen=YES, vsftpd listens for incoming FTP connections on IPv4 sockets exclusively. This is a traditional setup for most FTP servers that don’t need to support IPv6.

On the other hand, when we set listen_ipv6=YES, vsftpd listens on IPv6 sockets. If the system is configured to support IPv4-mapped addresses and dual-stack operations, these sockets can handle both IPv6 and IPv4 connections. This is often recommended for modern servers that need to support both IP stacks because it simplifies configuration and reduces potential conflicts.

However, the critical issue that leads to server startup failures is setting both listen=YES and listen_ipv6=YES simultaneously. This configuration attempts to bind both IPv4 and IPv6 separately, which can lead to port binding conflicts, especially if both settings attempt to use the same port number.

Thus, the recommended practice is to enable only one of these at a time, depending on whether our network supports IPv6 and whether it requires simultaneous handling of IPv4 connections.

In short, by setting listen_ipv6=YES and listen=NO, we enable vsftpd to handle connections on both IP stacks without conflicts, ensuring a smooth operation and broad compatibility across network setups.

4. Advanced Troubleshooting Techniques

If our initial checks don’t resolve the issue, it’s time to employ more advanced techniques to diagnose and fix the problem.

Let’s see some techniques we can put to use.

4.1. Running vsftpd from the Command Line

Running vsftpd directly from the command line with the config file can often provide more detailed error messages:

$ sudo /usr/sbin/vsftpd /etc/vsftpd.conf
500 OOPS: config file not owned by correct user, or not a file

Here, 500 OOPS is a common error prefix vsftpd used to indicate an error condition. This specific error tells us there is a problem with the configuration file’s ownership or nature. The owner should be root, and the file needs to be a regular file, not a symlink or directory.

However, depending on the error message, we might need to verify that the /etc/vsftpd.conf file is indeed a regular file and not a symbolic link or directory. We should also confirm the file’s ownership, ensuring it’s owned by root, as non-root ownership can be a security risk and is often not permitted by vsftpd for its configuration files.

4.2. Analyzing System Logs

We can also check the system logs for any entries related to vsftpd to gain insight into what might be going wrong.

In most cases, journalctl comes in handy to check the recent logs. The journalctl command is a powerful tool for querying the systemd journal, which stores logs for systemd services like vsftpd. This command can filter logs specifically for the vsftpd service, making it easier to pinpoint problems.

With the -u option with journalctl, we can specify the unit file of the service we want to analyze (in this case, vsftpd):

$ journalctl -u vsftpd
-- Logs begin at Thu 2023-04-20 17:34:00 EDT, end at Tue 2024-05-01 09:10:00 EDT. --
Apr 30 14:52:22 server-name systemd[1]: Starting vsftpd FTP server...
Apr 30 14:52:22 server-name vsftpd[2973]: pam_unix(vsftpd:auth): authentication failure; logname= uid=0 euid=0 tty=ftp ruser=ftp rhost=...
Apr 30 14:52:24 server-name vsftpd[2973]: vsftpd: could not bind listening IPv4 socket
Apr 30 14:52:24 server-name systemd[1]: vsftpd.service: control process exited, code=exited status=2
Apr 30 14:52:24 server-name systemd[1]: Failed to start vsftpd FTP server.
Apr 30 14:52:24 server-name systemd[1]: Unit vsftpd.service entered failed state.

In this scenario:

  • pam_unix(vsftpd:auth): authentication failure – shows a failed authentication attempt, which could indicate issues with user credentials or PAM configuration
  • could not bind listening IPv4 socket – typically means that the port vsftpd is configured to use (usually port 21 for FTP) is already in use by another service, or vsftpd does not have the necessary permissions to bind to that port
  • control process exited, code=exited status=2 – indicates that vsftpd exited with a status code of 2, which generally points to a configuration error

In short, our detailed log output from journalctl can guide us toward specific issues to investigate further, such as checking for port conflicts or authentication settings. Resolving these logged issues often helps in getting vsftpd back on its feet.

5. Networking and SELinux Considerations

If the issue persists after we complete the initial setup and other troubleshooting steps, it’s time to consider the broader context of our server’s environment, especially networking settings and security policies such as SELinux, which can affect vsftpd’s functionality.

5.1. Networking Issues With IPv6

If we have identified listen_ipv6 as a source of the problem or are experiencing issues with network connectivity, we should crosscheck the configuration of IPv6 on our server.

Alternatively, we can turn off IPv6 in vsftpd if it’s not needed:


After making changes, we should restart the vsftpd service:

$ sudo systemctl restart vsftpd

This restarts the vsftpd service and applies the new settings.

5.2. SELinux Settings

Security-Enhanced Linux (SELinux), if set up, can prevent vsftpd from accessing necessary files even if the permissions on those files are correctly set.

To check if SELinux is the cause, we can temporarily set it to permissive mode:

$ sudo setenforce 0

If vsftpd starts successfully with SELinux in permissive mode, we’ll need to adjust the SELinux policies rather than keep it in permissive mode.

5.3. Adjusting SELinux Policies

If vsftpd operates correctly in permissive mode, the next step is not to keep SELinux in permissive mode but rather to adjust the policies.

To do this, first, we create a policy module:

$ sudo audit2allow -a -M myvsftpd

This command reads denied entries from the audit log and creates a policy module to allow these previously denied actions. -M myvsftpd specifies the module’s name.

Afterward, we install the policy module:

$ sudo semodule -i myvsftpd.pp

This installs the newly created policy module.

Once we install this module, it allows vsftpd to perform the operations it needs to function without switching SELinux out of enforcing mode.

To digress a bit, SELinux operates in three modes:

  • Enforcing – the default mode where SELinux enforces its policies and denies access based on those policies, logging each denial. This mode ensures the active enforcement of security policies.
  • Permissive – this mode does not enforce its security policies but instead logs the actions that would have been denied if it were in enforcing mode. It’s useful for debugging and determining if SELinux is the cause of an issue without impacting system functionality.
  • Disabled – turns off SELinux entirely

In all, we should ensure our networking configurations and SELinux policies correctly align with our vsftpd setup. This stabilizes our FTP service against external and internal issues.

6. Automation and Workarounds

In situations where traditional troubleshooting doesn’t resolve the vsftpd startup issues or where we need a temporary fix while investigating other system problems, automation and scripting can provide a reliable fallback.

6.1. Using cron for Regular Service Checks

We can write a simple Bash script to check if vsftpd is running and start it if it isn’t.

Let’s see a basic Bash script we can set up to run at regular intervals using cron:


if (( $(ps -ef | grep -v grep | grep $service | wc -l) > 0 ))
echo "$service is running!!!"
service vsftpd start

We can then add this script to cron so it can run at intervals.

6.2. Ensuring Proper Logging

In addition to system checks, we should ensure that our vsftpd is logging events properly, which can aid in ongoing monitoring and future troubleshooting.

We need to verify that the log file path is correctly specified in the vsftpd configuration (/var/log/vsftpd.log) and check its contents regularly:

$ tail -f /var/log/vsftpd.log

Here, we use the tail command to show log entries as they are added to the file. It’s handy for troubleshooting connection issues or errors during specific operations.

However, if no logs are being written, we should enable logging in the vsftpd configuration file:

# Editing the /etc/vsftpd.conf file to enable logging


These steps ensure that vsftpd logs the necessary information into /var/log/vsftpd.log, which can be invaluable for troubleshooting and ensuring that our FTP server runs smoothly.

7. Conclusion

In this article, we covered a range of strategies to troubleshoot and resolve common issues with vsftpd, particularly when it fails to read its configuration file. Starting with basic checks, such as verifying file existence and permissions, we moved on to more detailed settings adjustments and system configurations.

Finally, we discussed leveraging system logs for deeper insights and introduced automation techniques for resilience. We should never forget that consistent monitoring and regular updates are vital in maintaining the health of any server application.

Notify of
Inline Feedbacks
View all comments