Skip to end of metadata
Go to start of metadata



RUSS can be built and installed from source (root not needed) or installed from pre-built packages (as root). However full functionality will require installation to the system directories.


Download pre-built package from:

For Ubuntu and Debian systems:

dpkg -i russng_7.0-ubuntu-18.04_amd64.deb

For RedHat systems:

rpm -i russng-7.0-rhel.7.x86_64.rpm


RUSS comes with a set of standard servers and sample configurations that can typically be copied in place without any modification:

cd /etc/russ/samples/conf
cp debug.conf exec.conf plus.conf proc.conf ssh.conf sshr.conf tee.conf /etc/russ/conf

Copy PAM support into place:

cd /etc/russ/samples/pam.d
cp russexec /etc/pam.d

Initial sync of configurations (don't at initial install or at reboot):

rubb --bb-all resync

Start all servers (for all bulletin boards):

rubb --bb-all restart


For status of all servers:

rubb --bb-all status

Check that the plus server/service is working:

ruhelp +

Execute service:

ruexec +/debug/daytime

Echo to stdout:

echo "hi" | ruexec +/debug/echo

Generate exit value:

ruexec +/debug/exit 5
echo $? 

Show help:

ruhelp +/debug

List services:

ruls +/debug

List all "system" servers:

ruls +

If you've got your ssh configuration set up to not require interaction (i.e., for a password/passphrase or to check host keys):

ruexec +/ssh/localhost/+/exec/shell "hostname; whoami"

If it all works, you're ready!