Skip to content

docs: update INSTALL with server build info #6372

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

wargoblin
Copy link
Contributor

Updated the INSTALL guide with instructions for configuring and building the server, and added pointers to scripts in the 3rdParty directory for downloading dependencies

make

More detailed information about setting up a server can be found on the
BOINC wiki (<https://boinc.berkeley.edu/trac/wiki/ServerIntro>).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

https://boinc.berkeley.edu/trac/wiki/ (here and above) is outdated, better to use the corresponding pages in GitHub wiki: https://github.com/BOINC/boinc/wiki

@@ -16,3 +16,20 @@ you can build and install BOINC libraries using [vcpkg](https://github.com/Micro
./vcpkg install boinc

The BOINC port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please [create an issue or pull request](https://github.com/Microsoft/vcpkg) on the vcpkg repository.

To build the BOINC server components use the normal configure and make steps
without `--disable-server`:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is confusing. It's better to specify which flags need to be set, not vice versa

have a look at the helper scripts in the `3rdParty` directory. They fetch and
build the required libraries on Linux and macOS:

./3rdParty/buildLinuxDependencies.sh
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is needed to build the client/manager, not the server

build the required libraries on Linux and macOS:

./3rdParty/buildLinuxDependencies.sh
./3rdParty/buildMacDependencies.sh
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we don't support building server of MacOS

@github-project-automation github-project-automation bot moved this to In progress in Client/Manager Jun 6, 2025
@github-project-automation github-project-automation bot moved this to Backlog in Server Jun 6, 2025
@AenBleidd AenBleidd added this to the Server Release 1.6.0 milestone Jun 6, 2025
@davidpanderson
Copy link
Contributor

This page is confusing. It shouldn't exist.
There are 7 separate cases:

  1. building the BOINC client and manager
    a) on Linux
    b) on Win with VS
    c) on Mac with XCode
  2. building an application linked with the BOINC API
    a) on Linux
    b) on Win with VS
    c) on Mac with XCode
  3. building the server software (on Linux)

We should (on the wiki) give a cookbook for each of these.

@AenBleidd
Copy link
Member

Then we should use this page as a enter-point with the links to all the other relevant wiki pages, including the information how to install BOINC client and Manager on any supported platform without building it from sources.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Status: In progress
Status: Backlog
Development

Successfully merging this pull request may close these issues.

3 participants