WWIV is compiled with the following compilers:
- MS Visual C++ 2019 Community Edition.
- GCC 8.3 (or later) on Linux (Debian10, Centos8 (with GCC 8 via SCL) or Ubuntu)
You will need CMake 3.9 or later to build WWIV.
Building WWIV BBS
We prefer contributors to FORK
wwivbbs repositories to their account and work from there.
Building on Windows
Installing Git or GitHub Desktop
You will need Git installed. You can use the GitHub Desktop GUI, but it's also easy
to use the commandline tool directly. You'll need to download Git and
install it. Make sure the
git command is in your PATH.
If you are using GitHub Desktop, this is likely in the folder: "Documents\GitHub\WWIV". Otherwise just
create a directory and clone your fork. You can follow instructions that are written by GitHub
Here. Just make sure that
when you clone the repo, you have "Recurse Submodules" specified in the tool, or using
--recurse-submodules on the commandline.
Download and Install Visual Studio
WWIV is compiled with the VS2019 compiler for windows. You can download Microsoft Visual Studio 2019 Community
Choose to installthe
Desktop development with C++ workload.
You also may want to optionally install the following "Individual Components":
Git For Windows (Only if you do not have this already) GitHub extension for Visaul Studio
Build WWIV (Windows)
If you cloned a git repository for your fork of WWIV, then select File then Open and choose Folder.
If you are using the GitHub for Windows extension, then from the Visual Studio IDE, select File and then
Open from Source ControlOn the bottom, you should see your local GIT repositories already. Above that you will see Login to GitHub, do that.
Now in your Local repositories (Documents\GitHub\WWIV), open the folder WWIV in Visual Studio. It should recognize the CMake build and be able to build WWIV.
When VS says "READY" on the bottom, go to Build on the menu and select Build Solution(F7). If you have any build errors, run Build one more time and see if that resolves itself as there can be timing issues on some machines.
You select whether or not you are building DEBUG or RELEASE on the toolbar. Those binaries and other built files will be places in a \debug and \release folder along side your github source files. ex:
Building on Linux
This only builds the binaries, it does NOT include the supporting files. Please follow the Linux Installation instructions for getting the supporting files in place.
** NOTE:** Do these steps as a non-root user; your BBS user would be the easiest from a file permissions perspective later on. root should never be used to compile binaries.
Install pre-requisite software
|git||to grab the source code for compiling|
|ncurses||ncurses-devel, libncurses5-dev, etc depending on your distro|
|cmake||3.9 or later|
|ninja-build||1.8 or later, earlier versions probably work too|
|g++||8.3.0 or later (easiest to install via build-essential on debian)|
If you are on debian, you can use
/builds/jenkins/linux/install-prereqs.sh to ensure that
the right software is installed. This command should be executed as root (using sudo)
Here's the list of binaries that will be built in the build directory:
Getting the source from GitHub
If you plan to have an active repo, we prefer contributors to FORK WWIVBBS repositories to their account and work from there.
Fork, then clone your fork
# Create a directory for your fork's clone. mkdir git chdir git # Clone your fork into the current directory (git). # Use your GitHub username instead of <em>YOUR-USERNAME</em> git clone --recurse-submodules -j8 https://github.com/<em>YOUR-USERNAME</em>/wwiv.git
Navigate to wwiv
Now change directory to the
/wwiv directory where you cloned the repository
and run the following:
mkdir _build cd _build ../cmake-config.sh cmake --build . --config Debug
Now you can enter the
bbs/admin/unix directory and run
Installation and SysOp Instructions
All the installation and SysOp administration information you need is in the WWIV Documentation
If you want to help out with WWIV BBS: