Introduction¶

NOTE: this is still in experimental stage - do not use or only do so if you know what you are doing ;)

About¶

chwurz is a tool to create, update, remove and manage users and chroots for
chrooted scponly. ( http://sublimation.org/scponly/wiki/index.php/Main_Page )

Installation¶

1) from the plentyfact debian repository

add the following line to your /etc/apt/sources.list

deb http://packages.plentyfact.org/debian/ squeeze/

or

deb http://packages.plentyfact.org/debian/ wheezy/

then install with

apt-get update
apt-get install chwurz

2) download the latest snapshots ( 0.1.6 )

http://projects.plentyfact.org/projects/list_files/chwurz

you can run chwurz from the src/ directory or run

make install

to install chwurz into /usr/local/sbin ( this will also install the manpage )

on debian and ubuntu chwurz depends on the packages "lua5.1" and "scponly"

3) from subversion

svn co http://svn.plentyfact.org/chwurz

Usage¶

see the manpage for all options and examples

Usage: chwurz [options]
Options:
    -c,--create    <-u username> create a new scponlyc chroot for a user
    -x,--update    <-u username> update the skeleton for chroot directory 
    -d,--delete    <-u username> delete the user account and chroot directories
    -w,--wipe      <-u username> delete the user acoount and remove everything inside the users chroot directory
    -l,--list      list all users in /etc/passwd with scponlyc shell

    -u,--user      <username> username of the chroot user

    -r,--root      <path> set the root directory for the chroot, 
                   if not given, /home/<username> will be used
    -p,--password  <password> password for the chroot user
    -i,--incoming  <directory_name> name of the users incoming directory ( the directory writable for the user )
                   if not given, "incoming" will be used by default

    -f,--force     do not ask for confirmation when performing delete/wipe

    -k,--pubkey    <keyfile>  use pubkey authentification, will bypass password prompt