Skip to content
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.

Sign up for GitHub

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

[docs] Remove BRIX from hardware recommendations; link from checklist #4075

Merged
merged 2 commits into from
Jan 29, 2019
Merged

[docs] Remove BRIX from hardware recommendations; link from checklist #4075

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
6afa1d6
[docs] Remove BRIX from hardware recommendations; link from checklist
eloquence Jan 25, 2019
606199b
No longer recommend Mac Mini, but keep instructions
eloquence Jan 28, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 5 additions & 2 deletions docs/checklists/pre_install_hardware.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,5 +5,8 @@ This is the *minimum* hardware that must be acquired to install SecureDrop:

.. include:: ../includes/pre-install-hardware.txt

.. note:: For additional details, please read the full document on
:ref:`Hardware Recommendations` for SecureDrop.
.. important:: To avoid hardware compatibility issues, we strongly recommend
adhering to our
:ref:`specific hardware recommendations <Specific Hardware Recommendations>`.
Please review the :ref:`Hardware <hardware_guide>` section in full for further
details.
28 changes: 1 addition & 27 deletions docs/hardware.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -272,39 +272,13 @@ Specific Hardware Recommendations
Application and Monitor Servers
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

We currently recommend the Gigabyte BRIX, Intel NUC, or Mac Mini for
SecureDrop servers.
We currently recommend the Intel NUC or Mac Mini for SecureDrop servers.
Copy link
Contributor

Choose a reason for hiding this comment

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

If we're going to continue to recommend the Mac Mini, we need to be explicit about either year (2014) or model numbers, and probably make a point of saying the 2018 ones won't work.

Copy link
Member Author

Choose a reason for hiding this comment

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

As of your changes in 2732588 we at least have a warning to that effect. I think we should keep the docs around (given the significant install base on Mic Mini), but we shouldn't say that "we currently recommend .. the Mac Mini". I'll take a stab at refactoring this section accordingly in a follow-up commit in this PR.

Copy link
Member Author

Choose a reason for hiding this comment

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

This is now done; @zenmonkeykstop, could you take another look?


.. note:: If using non-recommended hardware, ensure you remove as much
extraneous hardware as physically possible from your servers. This
could include: speakers, cameras, microphones, fingerprint readers,
wireless, and Bluetooth cards.

Gigabyte BRIX
~~~~~~~~~~~~~

The Gigabyte BRIX series is an inexpensive, quiet, low-power device that
can be used for SecureDrop servers. There are a
`variety of models <http://www.gigabyte.us/Mini-PcBarebone/BRIX>`__ to choose
from; we recommend the GB-BXi5-5575. It has a mid-range CPU (the 5th
generation Intel i5), a full-size HDMI port for a monitor, and four USB 2 ports.
If you select a different model series (such as the GB-BSi5H) carefully
verify that it uses the 5th generation Intel i5. Newer generation CPUs will
**not** work with SecureDrop.

The GB-BXi5-5575 supports wireless and Bluetooth through a removable card. This
removable card is preferable, since you want neither WiFi nor Bluetooth. You
can open the BRIX by removing the screws from the underside of the computer; the
wireless card has one small screw you need to remove and two small connectors.

The BRIXs come as kits, and some assembly is required. You will need to purchase
the RAM and hard drive separately for each BRIX and insert both into the machine
before it can be used. We recommend:

- 2x 240 GB SSDs (2.5")
- 1x memory kit of 2x4GB sticks (DIMM DDR3 1866MHz)
- You can put one 4GB memory stick in each of the servers.

Intel NUC
~~~~~~~~~

Expand Down