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
howto:raspbian_install [2018/03/01 12:11] – Links to util:binkit changed to module:binkit digital manhowto:raspbian_install [2024/03/22 16:58] (current) – [DOSEMU On Raspberry Pi 4 with 64 Bit OS] nelgin
Line 1: Line 1:
-====== Raspbian Install ======+====== Install Synchronet on a Raspberry Pi ======
  
-Here are step-by-step instructions on building and installing Synchronet on a [[http://www.raspbian.org/|Raspbian]] computer ([[http://www.raspberrypi.org|Raspberry Pi]] running [[http://www.debian.org/|Debian]] Linux OS).+Here are step-by-step instructions on building and installing Synchronet on a [[http://www.raspberrypi.org|Raspberry Pi]] running either [[http://www.raspbian.org/|Raspbian]] or [[https://www.raspberrypi.com/software/|Raspberry Pi OS 32-bit]].
  
 +**Note:** While Raspbian and the 32-bit version of Raspberry Pi OS are virtually identical, the 64-bit version of Raspberry Pi OS is a significant departure from Raspbian. These instructions are untested on the 64-bit version.
 +
 +{{:howto:rpi.png?100|}}
 ===== Prerequisites ===== ===== Prerequisites =====
  
-These instructions were created using a Raspberry Pi 3 Model B running Raspbian version 4.4.21:+These instructions were created using a Raspberry Pi 3 Model B running //Raspbian Stretch//, kernel version 4.4:
  
-  pi@raspberrypi:$ uname -a+  $ uname -a
   Linux raspberrypi 4.4.21-v7+ #911 SMP Thu Sep 15 14:22:38 BST 2016 armv7l GNU/Linux   Linux raspberrypi 4.4.21-v7+ #911 SMP Thu Sep 15 14:22:38 BST 2016 armv7l GNU/Linux
 +  
 +These instructions have recently been confirmed using a Raspberry Pi 3 Model B running //Raspbian Stretch Light//, kernel version 4.14:
  
 +  $ uname -a
 +  Linux raspberrypi 4.14.71-v7+ #1145 SMP Fri Sep 21 15:38:35 BST 2018 armv7l GNU/Linux
 +  
 +These instructions have recently been confirmed using a Raspberry Pi 4 running Raspberry Pi OS, kernel version 6.1.0:
 +  $ uname -a
 +  Linux raspberrypi 6.1.0-rpi7-rpi-v8 #1 SMP PREEMPT Debian 1:6.1.63-1+rpt1 (2023-11-24) aarch64 GNU/Linux
 ===== Instructions ===== ===== Instructions =====
  
-Get to a Terminal/command prompt (e.g. login via SSH or run the Terminal application from the PIXEL desktop). Login as your preferred user account to run the BBS software.+Get to a Terminal/command prompt (e.g. login via SSH or run the Terminal application from the PIXEL desktop). 
 + 
 +Login as your preferred user account to run the BBS software (e.g. the default user ''pi'', or create the user ''sbbs'' using the Linux ''adduser'' utility and then run ''su sbbs'' to login as the user ''sbbs''). 
 + 
 +These instructions install Synchronet (source code, executables, configuration, and data files) into a sub-directory named ''sbbs'' off of the home directory of the current user (e.g. ''~/sbbs''). So if the current user is "pi", that would expand to ''/home/pi/sbbs''. If you wish to install into a different directory (e.g. ''/sbbs'' instead of ''~/sbbs''), then change the following commands as you see fit, but that is not recommended. 
 + 
 +Install all the [[install:nix:prerequisites]] for Debian/Ubuntu for version 23.00 upwards then follow the instructions below: 
 +**Note: If using an Rpi4 use a 64 bit Raspberry Pi OS and download arm64 instead of armhf.** 
 +^ # ^ Command                                  ^ Description ^ 
 +| 1 | mkdir ~/deb_packages                 | Create a directory to store some packages for manual installation | 
 +| 2 | cd ~/deb_packages                    | Change the current working directory to the newly-created directory | 
 +| 3 | wget http://archive.debian.org/debian/pool/main/libf/libffi/libffi6_3.2.1-6_armhf.deb or \\ wget http://archive.debian.org/debian/pool/main/libf/libffi/libffi6_3.2.1-6_arm64.deb | Download libffi6 | 
 +| 4 | ''wget http://archive.debian.org/debian/pool/main/m/mozjs/libmozjs185-1.0_1.8.5-1.0.0+dfsg-6_armhf.deb or\\ wget http://archive.debian.org/debian/pool/main/m/mozjs/libmozjs185-1.0_1.8.5-1.0.0+dfsg-6_arm64.deb'' | Download libmozjs185-1.0 | 
 +| 5 | ''wget http://archive.debian.org/debian/pool/main/m/mozjs/libmozjs185-dev_1.8.5-1.0.0+dfsg-6_armhf.deb or\\ wget http://archive.debian.org/debian/pool/main/m/mozjs/libmozjs185-dev_1.8.5-1.0.0+dfsg-6_arm64.deb'' | Download libmozjs185-dev | 
 +| 6 | ''sudo apt install ./lib*.deb'' | Install libs and dependencies| 
 +| 7 | ''mkdir ~/sbbs''                         | Create the directory where Synchronet will be built and run from | 
 +| 8 | ''cd ~/sbbs''                            | Change the current working directory to the newly-created directory | 
 +| 9 | ''wget [[https://gitlab.synchro.net/sbbs/sbbs/-/raw/master/install/GNUmakefile]]'' | [[install:nix:Fetch makefile]] | 
 +|10 | ''make install SYMLINK=1 JSINCLUDE=/usr/include/js JSLIB=mozjs185'' | Build it (will likely take quite a while) | 
 +|11 | ''export SBBSCTRL=~/sbbs/ctrl''          | See [[config:env]] for details on setting this environment variable persistently | 
 +|12 | ''~/sbbs/exec/[[util:scfg]]''            | Configure your BBS, see ''[[config:sbbs.ini]]'' for more Synchronet server settings | 
 + 
 +Now you are ready to either run ''sbbs'' with interactive sysop console: 
 + 
 +  $ ~/sbbs/exec/sbbs 
 +   
 +or see [[systemd|this how-to]] for instructions on how to run ''sbbs'' as a daemon using systemd. 
 + 
 +**Note**:\\ 
 +This will create 32-bit ARM binaries (executables): 
 +  $ file -L sbbs 
 +  sbbs: ELF 32-bit LSB executable, ARM, EABI5 version 1 (SYSV), dynamically linked, interpreter /lib/ld-linux-armhf.so.3, for GNU/Linux 3.2.0 
 +   
 +Although it [[https://www.tal.org/tutorials/raspberry-pi3-build-64-bit-kernel|is possible]] to create 64-bit ARM binaries for the Raspberry Pi 3/3+ through cross-compilation, this is not supported by the Raspberry Pi foundation and thus not covered here. 
 + 
 +====== DOSEMU On Raspberry Pi 4 with 64 Bit OS ====== 
 + 
 +You will need to add the DosEMU2 Launchpad PPA to your system. 
 + 
 +First, add the public key 
 + 
 +  $ sudo curl -sS 'https://keyserver.ubuntu.com/pks/lookup?op=get&search=0xebe1b5ded2ad45d6'|gpg --dearmor > /etc/apt/trusted.gpg.d/ubuntu-dosemu2-ppa.gpg 
 + 
 +This step seems to be a challenge for some people so you may have to break it into a couple of steps 
 + 
 +  $   curl -sS 'https://keyserver.ubuntu.com/pks/lookup?op=get&search=0xebe1b5ded2ad45d6' | gpg --dearmor > /tmp/dosemupgp.txt 
 +  $   sudo mv /tmp/dosemupgp.txt /etc/apt/trusted.gpg.d/ubuntu-dosemu2-ppa.gpg 
 +   
 +Second, create a source file 
 + 
 +  $ sudo echo "deb https://ppa.launchpadcontent.net/dosemu2/ppa/ubuntu kinetic main" > /etc/apt/sources.list.d/dosemu2 
 +   
 +Next, run apt update to make sure there are no issues 
 + 
 +  $ sudo apt update 
 +   
 +Then install the DosEMU2 files
  
-These instructions install Synchronet (source code, executables, configuration, and data files) into a sub-directory named ''sbbs'' off of the home directory of the current user (e.g. ''/home/pi/sbbs'' if logged in as the user ''pi''). If you wish to install into a different directory (e.g. ''/sbbs'' instead of ''~/sbbs''), then change the following commands as you see fit.+  $ apt install dosemu2 
 +   
 +A number of packages will be installed.
  
-Type each of these commands:+Finally, download Nelgin's dosemu2 configurations. Untar the file and follow the readme. You should be left with a working DosEMU
  
-  - ''sudo apt-get update'' + wget https://www.endofthelinebbs.com/dosemu2.tar.gz 
-  - ''sudo apt-get install cvs'' + $ tar xf dosemu2.tar.gz
-  - ''sudo apt-get install zip'' +
-  - ''sudo apt-get install libnspr4-dev'' +
-  - ''sudo apt-get install libncurses5-dev'' +
-  - ''mkdir ~/sbbs'' +
-  - ''cd ~/sbbs'' +
-  - ''[[install:nix:fetch makefile|wget http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/install/GNUmakefile]]'' +
-  - ''make install SYMLINK=1'' (wait for build to complete successfully) +
-  - ''export SBBSCTRL=~/sbbs/ctrl'' +
-  - ''~/sbbs/exec/[[module:binkit]]'' (configure as desired, see ''[[config:sbbs.ini]]'' for more Synchronet server settings)+
  
-Now you are ready to either run ''~/sbbs/exec/sbbs'' directly (you'll need to run using ''sudo'' if you want to use TCP ports < 1024) or see [[systemd|this how-to]] for instructions on how to run ''sbbs'' as a daemon using systemd. 
  
 ===== See Also ===== ===== See Also =====
howto/raspbian_install.1519935062.txt · Last modified: 2018/03/01 12:11 by digital man
Back to top
CC Attribution 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0