trAvis - MANAGER

Edit File: Nonroot.html

<html>
<head>
<title>ProFTPD mini-HOWTO - Running by nonroot user</title>
</head>

<hr>
<center><h2>Running ProFTPD as a Nonroot User</h2></center>
<hr>

Occasionally, one might want to run ProFTPD on a system where root privs
are not available to you as a user. It is still possible to setup a
functioning FTP server without root privileges. There are a few catches
and special considerations for this, however.

Here are the configuration directives that you will need to use in order
to run the server without root privileges:

<ul>
 <li><code>Port</code> 
 This needs to be a number greater than 1023. Lower number ports require
 root privileges in order for the process to bind to that address. This
 will also mean that clients wishing to contact your server will need to
 know the port on which it is listening. Most FTP clients connect to the
 standard FTP port (21).
 
 
 Example:
<pre>
 Port 20021
</pre>
 </li>
 
 <li><code>AuthUserFile, AuthGroupFile</code> 
 In order to authenticate users, by default the server looks in
 <code>/etc/passwd</code> for account information, and in
 <code>/etc/shadow</code> for the password. Comparing stored passwords
 requires root privileges, which this nonroot-running daemon will not have.
 You can get around this requirement by supplying your own passwd (and
 possibly group) files via the <a href="http://www.proftpd.org/docs/directives/linked/config_ref_AuthUserFile.html"><code>AuthUserFile</code></a> and
 <a href="http://www.proftpd.org/docs/directives/linked/config_ref_AuthGroupFile.html"><code>AuthGroupFile</code></a> directives. Make sure the permissions on your
 custom files allow for the daemon to read them (but hopefully not other
 users).

Example:
<pre>
 AuthUserFile /path/to/custom/ftpd.passwd
 AuthGroupFile /path/to/custom/ftpd.group
</pre>
 </li>

<li><code>AuthPAM</code> 
 PAM authentication requires root privileges. This directive will need
 to be set off.
 
 
 Example:
<pre>
 AuthPAM off
</pre>
 </li>

<li><code>PidFile</code> 
 This directive will need to be used to cause the server to write its PID
 to some file writable by the user.

Example:
<pre>
 PidFile /home/bob/ftpd/proftpd.pid
</pre>
 </li>

<li><code>ScoreboardFile</code> 
 This directive will need to be used to cause the server to write its
 scoreboard to some file writable by the user.

Example:
<pre>
 ScoreboardFile /home/bob/ftpd/proftpd.scoreboard
</pre>
 </li>

<li><code>WtmpLog</code> 
 Logging to <code>wtmp</code> files requires root privileges. While it is
 not strictly necessary for this directive to be set to off, failure
 to do so will result in server log messages like:
<pre>
 host.domain.net (localhost[127.0.0.1]) - wtmpx /var/adm/wtmpx: Permission denied
</pre>

Example:
<pre>
 WtmpLog off
</pre>
 </li>

<li><code>User, Group</code> 
 The ability to switch the identity of the server process to those configured
 by the <a href="http://www.proftpd.org/docs/linked/config_ref_User.html"><code>User</code></a> and
 <a href="http://www.proftpd.org/docs/linked/config_ref_Group.html"><code>Group</code></a> directives requires, of course, root privileges. It is best to
 configure <code>User</code> to be your username, and <code>Group</code> to
 be the name of your primary group (which is usually the first group listed
 by the <code>groups</code> command).

Example:
<pre>
 User bob
 Group bob
</pre>
 </li>
</ul>

Note that other configuration directives will be affected by the lack of
root privileges: <code>DefaultRoot</code> will not work, nor will
<code>&lt;Anonymous&gt;</code> sections, nor <code>UserOwner</code>.
Basically any operation that requires root privileges will be disabled.

If using the <code>SystemLog</code> directive, make sure the file to which the
server is to log can be written to by the configured daemon <code>User</code>
or <code>Group</code>.

The daemon should now start successfully. Complaints about not being able
to switch UIDs and such will be logged, but the daemon should still function
properly.