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
install:nix [2024/10/11 21:40] – [Git Build Method] Emphasize that the install/GNUmakefile should be deleted after installation. digital maninstall:nix [2026/03/17 02:53] (current) – [Git Build Method] use sbbs321e tag as example digital man
Line 66: Line 66:
 ==== Git Build Method ==== ==== Git Build Method ====
  
-Quick installation from [[dev:Git]] (requires 100+MB of disk space):+Quick installation from [[dev:Git]] (requires about 1.2GB of available disk space):
  
-  * ''$ [[install:nix:fetch makefile|wget]] [[https://gitlab.synchro.net/main/sbbs/-/raw/master/install/GNUmakefile]]''+  * ''$ [[install:nix:fetch makefile|wget]] [[https://gitlab.synchro.net/main/sbbs/-/raw/master/install/install-sbbs.mk]]''
  
 To get and build the latest code: To get and build the latest code:
  
-  * ''$ [[install:nix:make|make]] install SYMLINK=1''+  * ''$ [[install:nix:make|make]] -f install-sbbs.mk SYMLINK=1''
  
 On Linux, it's normal that the user's password may be prompted for near the end of the build process, as required to invoke the ''sudo setcap'' command to enable low-port-binding capability on the Synchronet ''sbbs'' executable. On Linux, it's normal that the user's password may be prompted for near the end of the build process, as required to invoke the ''sudo setcap'' command to enable low-port-binding capability on the Synchronet ''sbbs'' executable.
Line 78: Line 78:
 If building on a Linux system as a user without ''sudo'' access, pass the ''NOCAP=1'' option to disable this function((there are other methods of enabling low-port binding on Linux systems)): If building on a Linux system as a user without ''sudo'' access, pass the ''NOCAP=1'' option to disable this function((there are other methods of enabling low-port binding on Linux systems)):
  
-  * ''$ [[install:nix:make|make]] install SYMLINK=1 NOCAP=1''+  * ''$ [[install:nix:make|make]] -f install-sbbs.mk SYMLINK=1 NOCAP=1''
  
-Or, if you want to build a stable release from Git, specify a valid release [[dev:tags|tag]] on the make command-line (e.g. ''sbbs319b''): +Or, if you want to build a stable release from Git, specify a valid release [[dev:tags|tag]] on the make command-line (e.g. ''sbbs321e''): 
-  * ''$ [[install:nix:make|make]] install SYMLINK=1 **TAG=sbbs3xxx**''+  * ''$ [[install:nix:make|make]] -f install-sbbs.mk SYMLINK=1 **TAG=sbbs3xxx**''
   * **NOTE**: this does not work with release tags earlier than ''sbbs319b'', use the Tarball install method instead for those.   * **NOTE**: this does not work with release tags earlier than ''sbbs319b'', use the Tarball install method instead for those.
  
Line 87: Line 87:
   * These commands will make and install a //RELEASE// build of the software. To make and install a //DEBUG// build instead, pass ''DEBUG=1'' on the ''make'' command-lines.   * These commands will make and install a //RELEASE// build of the software. To make and install a //DEBUG// build instead, pass ''DEBUG=1'' on the ''make'' command-lines.
   * We don't support parallel builds (e.g. ''make -j'') - so don't do that.   * We don't support parallel builds (e.g. ''make -j'') - so don't do that.
-  * Mirrors of the ''install/GNUmakefile'' are available at +  * Mirrors of the ''install/install-sbbs.mk'' are available at 
-      * [[https://github.com/SynchronetBBS/sbbs/raw/master/install/GNUmakefile]] +      * [[https://github.com/SynchronetBBS/sbbs/raw/master/install/install-sbbs.mk]] 
-      * [[https://gitlab.com/SynchronetBBS/sbbs/-/raw/master/install/GNUmakefile]]+      * [[https://gitlab.com/SynchronetBBS/sbbs/-/raw/master/install/install-sbbs.mk]]
  
  
Line 98: Line 98:
 lrwxrwxrwx 1 sbbs sbbs    25 Jan 26 21:03 docs -> /home/sbbs/sbbs/repo/docs lrwxrwxrwx 1 sbbs sbbs    25 Jan 26 21:03 docs -> /home/sbbs/sbbs/repo/docs
 lrwxrwxrwx 1 sbbs sbbs    25 Jan 26 21:03 exec -> /home/sbbs/sbbs/repo/exec lrwxrwxrwx 1 sbbs sbbs    25 Jan 26 21:03 exec -> /home/sbbs/sbbs/repo/exec
--rw-r--r-- 1 sbbs sbbs 11001 Jan 26 20:51 GNUmakefile+-rw-r--r-- 1 sbbs sbbs 11001 Jan 26 20:51 install-sbbs.mk
 drwxr-xr-x 1 sbbs sbbs   116 Jan 26 21:07 node1 drwxr-xr-x 1 sbbs sbbs   116 Jan 26 21:07 node1
 drwxr-xr-x 1 sbbs sbbs    48 Jan 26 21:06 node2 drwxr-xr-x 1 sbbs sbbs    48 Jan 26 21:06 node2
Line 113: Line 113:
  
 **Notes**: **Notes**:
-  * You can safely remove the installation ''GNUmakefile'' once successfully installed; it has served its purpose. +  * You can safely remove the installation ''install-sbbs.mk'' once successfully installed; it has served its purpose.
-  * In fact, you probably **should delete the installation ''GNUmakefile''** at this point to prevent accidental re-installation of ''sbbs'' later.+
  
 ==== Tarball Build Method ==== ==== Tarball Build Method ====
Line 128: Line 127:
  
 If you want to build a stable release, replace the archive filenames above with valid release filenames: If you want to build a stable release, replace the archive filenames above with valid release filenames:
-  - replace ''sbbs_src.tgz'' with ''ssrc**319b**.tgz'' +  - replace ''sbbs_src.tgz'' with ''ssrc**321c**.tgz'' 
-  - replace ''sbbs_run.tgz'' with ''srun**319b**.tgz''+  - replace ''sbbs_run.tgz'' with ''srun**321c**.tgz''
  
 ==Using System Libraries== ==Using System Libraries==
Line 171: Line 170:
     error: unknown type name 'wint_t'     error: unknown type name 'wint_t'
  
-  * The following error indicates the Synchronet libraries (shared objects) are not in your system's library search path or in the directory from which ''sbbs'' was built. Set the ''LD_LIBRARY_PATH'' [[config:env|environment variable]] to point to your Synchronet ''[[dir:exec]]'' directory or add that directory to your ''/etc/ld.so.conf'' file (and run ''ldconfig'') to resolve:+  * The following error indicates the Synchronet libraries (shared objects) are not in your system's library search path or in the directory from which ''sbbs'' was built. You can try setting the ''LD_LIBRARY_PATH'' [[config:env|environment variable]] to point to your Synchronet ''[[dir:exec]]'' directory or add that directory to your ''/etc/ld.so.conf'' file (and run ''ldconfig'') to work around.  Please report a bug if this works, as it should never be necessary.:
  
     sbbs: error while loading shared libraries: libsbbs.so: cannot open shared object file: No such file or directory     sbbs: error while loading shared libraries: libsbbs.so: cannot open shared object file: No such file or directory
 +
 +  * The following compilation error indicates that a source file has been removed or renamed in the project, you need to ''make clean'' first:
 +
 +    make: *** No rule to make target 'js_archive.c', needed by 'gcc.linux.x64.obj.release-mt/js_archive.o'.  Stop. 
 +    
 +    make: *** No rule to make target 'ftpsrvr.c', needed by 'gcc.linux.x64.obj.debug-mt/ftpsrvr.o'.  Stop.
  
 ==== Notes ==== ==== Notes ====
Line 208: Line 213:
 get from the devs is "don't do that then". Partial documentation can be found here: [[:install:nix:options]] get from the devs is "don't do that then". Partial documentation can be found here: [[:install:nix:options]]
  
-=== Third Party Builds ===+=== Pre-built Binaries ===
  
-Some third parties make unsupported tarballs available from their own sites.  Using them is not recommended or supported.  Whenever possible you should build yourself.+Some parties make pre-built executable binaries available for download.  Whenever possible, you should build executables for your platform yourself.
  
-^ OS               ^ Platform     ^ Provided By ^ Date      ^ Archive                                          ^ +^ OS               ^ Architecture ^ Provided By ^ Date      ^ Archive                                          ^ 
-| Debian (testing) | amd64        | [[person:digital_man]]  | Every morning (PT) | [[ftp://ftp.synchro.net/sbbs_dev.tgz|sbbs_dev.tgz]] [[ftp://ftp.synchro.net/sbbs_run.tgz|sbbs_run.tgz]] |+| Debian Linux     | AMD64/x86-64 | [[person:digital_man]]  | Every morning (PT) | [[https://vert.synchro.net/Synchronet/sbbs_dev.tgz|sbbs_dev.tgz]] | 
 +| macOS            | ARMv8        | [[person:digital_man]]  | Every morning (PT) | [[https://vert.synchro.net/Synchronet/sbbs_dev-macos-armv8.tgz|sbbs_dev-macos-armv8.tgz]] |
  
 ===== Configuring ===== ===== Configuring =====

Trace: