Synchronet v3.21e-Win32 (install) has been released (Mar-2026).

You can donate to the Synchronet project using PayPal.

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
config:nix [2011/10/25 23:01] – remove stuff that's installation related (moving to install:nix). digitalmanconfig:nix [2026/02/21 21:15] (current) – Include instructions for how to integrate your UNIX mail system with Synchronet using sendmail.js digital man
Line 1: Line 1:
 ====== UNIX ====== ====== UNIX ======
  
-===== sbbs.ini =====+Configuration of ''[UNIX]'' section of the Synchronet initialization file (e.g. ''[[dir:ctrl]]/[[config:sbbs.ini]]'').
  
-Unix/Linux Sysops will particularly want to pay attention to the ''[UNIX]'' section of your Synchronet initialization file (e.g. ''[[dir:ctrl]]/[[config:sbbs.ini]]'').+===== User/Group ===== 
 +If you are **not** [[howto:linux_non-root|starting sbbs as ''root'']], then you should **not** set these values.
  
 ==== User ==== ==== User ====
Line 20: Line 21:
   User=sbbsuser   User=sbbsuser
   Group=sbbsgroup   Group=sbbsgroup
 +  
 +NOTE: the ''sbbsuser'' and ''sbbsgroup'' names are just examples. You must pick valid user/group names for your system (e.g. exist in your system's ''/etc/passwd'' file) and both the user and group name may be the same.
      
 Also, the Synchronet file Also, the Synchronet file
Line 27: Line 30:
  
   # chown -R sbbsuser:sbbsgroup /sbbs   # chown -R sbbsuser:sbbsgroup /sbbs
 +
 +If you do this, then be sure to run any Synchronet utilities (e.g. [[util:SCFG]]) as the same user that the BBS is going to run as:
      
 +  # su -c /sbbs/exec/scfg sbbs  
 +
 +===== Logging =====
 ==== LogFacility ====  ==== LogFacility ==== 
  
Line 39: Line 47:
   LogFacility=3   LogFacility=3
    
-Then, in ''/etc/syslog.conf'' you will need to add the line:+Then, in ''/etc/syslog.conf'' (or ''/etc/rsyslog.d/sbbslog.conf'') you will need to add the line:
  
   local3.*                 /var/log/sbbs.log   local3.*                 /var/log/sbbs.log
Line 54: Line 62:
 Then send a HUP to syslogd like so: Then send a HUP to syslogd like so:
   # killall -HUP syslogd   # killall -HUP syslogd
 +  
 +Or it might be necessary to:
 +  # service syslogd restart
      
 You could then monitor the Synchronet daemon log output with: You could then monitor the Synchronet daemon log output with:
Line 94: Line 105:
  
 This is the value passed as the ''ident'' argument to the system's ''openlog'' function. Run ''man openlog'' for more details on this setting. This is the value passed as the ''ident'' argument to the system's ''openlog'' function. Run ''man openlog'' for more details on this setting.
 +
 +===== Process Control ===== 
  
 ==== PidFile ==== ==== PidFile ====
  
-Default: ''/var/run/sbbs.pid''+Default: ''sbbs.pid''
  
-This key contains the path of the file which will contain the program identify (PID) of Synchronet and is used to by backgrou/daemon startup scripts to query the current state of ''sbbs''.+This key contains the path of the file which will contain the process identifier (PID) of Synchronet and may be used by background/daemon startup scripts to query the current state of ''sbbs''. When no path is specified, the file (e.g. ''sbbs.pid'') will be created in the Synchronet ''[[dir:ctrl]]'' directory.
  
   # service sbbs status   # service sbbs status
Line 105: Line 118:
   PID(s): 6270   PID(s): 6270
  
-If you change the value of this key, you may also need to change/update your startup script (e.g. ''/etc/init.d/sbbs'').+If you change the value of this key, you may also need to modify your startup script (e.g. ''/etc/init.d/sbbs'').
  
 ==== umask ==== ==== umask ====
Line 113: Line 126:
 Sets ''sbbs'''s  file mode creation mask. Sets ''sbbs'''s  file mode creation mask.
  
-Note: If the value begins with a ''0'', it will be interpretted as //octal// notation.+Note: If the value begins with a ''0'', it will be interpreted in //octal// notation.
  
 Run ''man umask'' for more details on this setting. Run ''man umask'' for more details on this setting.
Line 121: Line 134:
 Default: ''false'' Default: ''false''
  
-When set to ''true'', forces ''sbbs'' to run daemonized (in the background) without specifying the ''-d'' command-line option.+When set to ''true'', forces ''sbbs'' to run daemonized (in the background) without specifying the ''-d'' command-line option. Setting this value to ''true'' is not recommended. 
 + 
 +===== Email ===== 
 + 
 +Synchronet's mail base and mail server can be used as your UNIX system's email system, if you wish. 
 + 
 +==== sendmail.js ==== 
 + 
 +The Synchronet ''[[module:sendmail]]'' module can be used as a suitable replace for: 
 +  * /usr/sbin/sendmail 
 +  * /usr/bin/mail 
 +  * /usr/bin/mailx 
 + 
 +This is achieved by making symbolic links (e.g. using ''ln -s'') from those locations to the Synchronet ''[[dir:exec]]/sendmail.js'' file. For example: 
 + 
 +  lrwxrwxrwx 1 root root     37 Feb 13  2023 /usr/bin/mail -> /home/sbbs/sbbs/exec/sendmail.js 
 +  lrwxrwxrwx 1 root root     37 Feb 12  2023 /usr/sbin/sendmail -> /home/sbbs/sbbs/exec/sendmail.js 
 +   
 +This works because the ''sendmail.js'' has a "shebang" that auto-invokes [[util:jsexec]]. That shebang has the path ''/sbbs/exec/jsexec'' hard-coded in it (as is the UNIX way), so you may need a symlink from ''/sbbs'' to wherever the proper 'sbbs' location is for that to work as expected: 
 +  #!/sbbs/exec/jsexec -x
  
 ===== See Also ===== ===== See Also =====
   * [[:config:|Configuration]]   * [[:config:|Configuration]]
 +  * [[:monitor:syslog]]
 +
  
 +{{tag>configuration unix operating_system sendmail email}}

Trace: