diff --git a/doc/EN/faq.org b/doc/EN/faq.org index 76749c98..b34bbc97 100644 --- a/doc/EN/faq.org +++ b/doc/EN/faq.org @@ -20,6 +20,7 @@ | [[What applications are supported?]] | | [[I don't have a static IP address. Can I still install this system?]] | | [[What are the best microSD cards to use?]] | +| [[On a single board computer can I boot from an external SSD or hard drive?]] | | [[Why Freedombone and not FreedomBox?]] | | [[Why not support building images for Raspberry Pi?]] | | [[Why use Tor? I've heard it's used by bad people]] | @@ -62,6 +63,22 @@ Yes. The minimum requirements are to have some hardware that you can install Deb The lack of a static IP address can be worked around by using a dynamic DNS service. Freedombone uses [[https://troglobit.com/inadyn.html][inadyn]] , which supports a variety of dynamic DNS providers. * What are the best microSD cards to use? There can be big differences in the performance of microSD cards, and the cheaper ones are almost invariably terrible and/or unusable. Sandisk and Samsung currently appear to be the better brands. You can find some performance benchmarks [[http://www.pidramble.com/wiki/benchmarks/microsd-cards][here]]. However, benchmarks like this only give a very rough idea of performance and they can vary significantly between individual cards even within the same brand. +* On a single board computer can I boot from an external SSD or hard drive? +Some single board computers, such as Cubieboards or OLinuxino, have a SATA socket on them which enables an external drive to be connected. This is usually intended for extra file storage, but it is also possible to run the operating system from an external drive. This can have the advantage of significantly increasing the read/write performance and your apps will appear to run more quickly. + +Typically a microSD read speed is 10-30MB/s. An SSD or hard drive can be 100MB/s or more, so that's a big potential gain. + +Single board computers usually don't have the capability of booting directly from an external drive, but what you can do is boot from a partition on a microSD drive, which then runs the main filesystem (the rootfs) from the external drive. + +To create an image suitable for running from an SSD or hard drive use the --sata option, such as: + +#+BEGIN_SRC bash +freedombone-image -t cubieboard2 --sata sda2 +#+END_SRC + +Note that the sata option should be set to point to the second partition on the drive, which is normally sda2. + +When the image is created then use the dd command to copy it both to a microSD card and to the SSD or hard drive. Plug them both into the board and it should then boot and use the external drive. * Why Freedombone and not FreedomBox? When the project began in late 2013 the FreedomBox project seemed to be going nowhere, and was only designed to work with the DreamPlug hardware. There was some new hardware out - the Beaglebone Black - which could run Debian and was also a free hardware design so seemed more appropriate. Hence the name "Freedombone", being like FreedomBox but on a Beaglebone. There are some similarities and differences between the two projects: diff --git a/doc/EN/homeserver.org b/doc/EN/homeserver.org index 496ad9fe..59381baa 100644 --- a/doc/EN/homeserver.org +++ b/doc/EN/homeserver.org @@ -119,7 +119,7 @@ Use the password you wrote down earlier to log in. Select the *administrator con Then select *About*. You'll see a list of sites and their onion addresses. -#+attr_html: :width 80% :align center +#+attr_html: :width 100% :align center [[file:images/controlpanel/control_panel_about.jpg]] The About screen contains the ssh server public key hashes and you can compare the relevant one with the previous terminal window to verify that they're the same. If they're not then you might have a /machine-in-the-middle/ snooping on you. diff --git a/doc/EN/mobile.org b/doc/EN/mobile.org index 3e5811d1..e7bde0ed 100644 --- a/doc/EN/mobile.org +++ b/doc/EN/mobile.org @@ -9,37 +9,8 @@ #+attr_html: :width 80% :height 10% :align center [[file:images/logo.png]] -* Mobile - Mobile phones are insecure devices, but they're regarded as being so essential to modern life that telling people not to use them isn't a viable option. Here are some recommendations on setting up a mobile phone (aka "smartphone") to work with Freedombone. -#+BEGIN_EXPORT html -
- - - - - - - - - - - - - - - - - - - - - -

Open


Use a free and open source operating system. Open means more trustworthy

Remove


If there are any proprietary apps then remove or deactivate them

Encrypt


Make sure your phone is encrypted with a password which isn't easy to guess

Apps


Use F-droid to install new apps

Lock


Enable a lock screen with a maximum number of password guesses

Onion


Onion route your connections to avoid bulk metadata collection

Email


Access webmail in a browser

Services


Connect to the Freedombone services

Battery


Avoid battery-eating apps and disable some optimisations

Block


Prevent access to know bad domains
-
-#+END_EXPORT - * Open Use a Linux based phone operating system. Typically this will mean Android, but could also mean LineageOS or Replicant. LineageOS is the most preferable, because you can usually get an up to date image with a recent kernel which will give you better security against exploits. If you're buying a phone then look for a model which is supported by LineageOS. Replicant is the most free (as in freedom) but only runs on a small number of phone models. If you have a phone which runs a full GNU/Linux system then that's fantastic, and you can probably use it in much the same way as a desktop system and the rest of the advice on this page won't apply. If you don't have a phone capable of running a Linux based operating system then consider selling, giving away or bartering your existing one. diff --git a/img/controlpanel/control_panel_about.jpg b/img/controlpanel/control_panel_about.jpg index e19dd6d4..658dac33 100644 Binary files a/img/controlpanel/control_panel_about.jpg and b/img/controlpanel/control_panel_about.jpg differ diff --git a/man/freedombone-image.1.gz b/man/freedombone-image.1.gz index 008c1afa..64101dca 100644 Binary files a/man/freedombone-image.1.gz and b/man/freedombone-image.1.gz differ diff --git a/src/freedombone-app-pleroma b/src/freedombone-app-pleroma index e48bfce8..3a38462c 100755 --- a/src/freedombone-app-pleroma +++ b/src/freedombone-app-pleroma @@ -36,7 +36,7 @@ PLEROMA_CODE= PLEROMA_PORT=4000 PLEROMA_ONION_PORT=8011 PLEROMA_REPO="https://git.pleroma.social/pleroma/pleroma.git" -PLEROMA_COMMIT='e153b364a71de431787db236c57114f229162ddf' +PLEROMA_COMMIT='fc6f5bcad3ad94eefbfcb24ca361e818ed0319d6' PLEROMA_ADMIN_PASSWORD= PLEROMA_DIR=/etc/pleroma PLEROMA_SECRET_KEY="" @@ -724,6 +724,33 @@ function configure_interactive_pleroma { done } +function pleroma_upgrade_tor { + pleroma_tor_update= + + if ! grep -q '{:socks5, :localhost, 9050}' $pleroma_secret; then + pleroma_tor_update=1 + fi + + if ! grep -q '# config :pleroma, :http, proxy_url:' $PLEROMA_DIR/config/config.exs; then + pleroma_tor_update=1 + fi + + if [ ! $pleroma_tor_update ]; then + return + fi + + if ! grep -q '{:socks5, :localhost, 9050}' $pleroma_secret; then + sed -i '/9050/d' $pleroma_secret + sed -i '/url:/a config :pleroma, :http, proxy_url: {:socks5, :localhost, 9050}' $pleroma_secret + fi + + if ! grep -q '# config :pleroma, :http, proxy_url:' $PLEROMA_DIR/config/config.exs; then + sed -i 's|config :pleroma, :http, proxy_url:|# config :pleroma, :http, proxy_url:|g' $PLEROMA_DIR/config/config.exs + fi + + pleroma_recompile +} + function upgrade_pleroma { read_config_param PLEROMA_DOMAIN_NAME read_config_param PLEROMA_EXPIRE_MONTHS @@ -738,6 +765,8 @@ function upgrade_pleroma { create_pleroma_blocklist fi + pleroma_upgrade_tor + CURR_PLEROMA_COMMIT=$(get_completion_param "pleroma commit") if [[ "$CURR_PLEROMA_COMMIT" == "$PLEROMA_COMMIT" ]]; then return @@ -748,6 +777,11 @@ function upgrade_pleroma { pleroma_registrations= fi + pleroma_chat_enabled=1 + if grep -q ':chat, enabled: false' $PLEROMA_DIR/config/config.exs; then + pleroma_chat_enabled= + fi + # make a copy of the configuration cp $PLEROMA_DIR/priv/static/static/config.json $PLEROMA_DIR/priv/static/static/config_prev.json @@ -780,6 +814,12 @@ function upgrade_pleroma { sed -i 's|registrations_open: True|registrations_open: false|g' $PLEROMA_DIR/config/config.exs fi + if [ ! $pleroma_chat_enabled ]; then + sed -i 's|config :pleroma, :chat.*|config :pleroma, :chat, enabled: false|g' $PLEROMA_DIR/config/config.exs + else + sed -i 's|config :pleroma, :chat.*|config :pleroma, :chat, enabled: true|g' $PLEROMA_DIR/config/config.exs + fi + pleroma_recompile # migrate database @@ -1252,6 +1292,10 @@ function install_pleroma { sed -i 's|redirect_on_failure:.*|redirect_on_failure: false|g' $PLEROMA_DIR/config/config.exs sed -i 's|:chat, enabled:.*|:chat, enabled: false|g' $PLEROMA_DIR/config/config.exs + # onion routing + sed -i '/url:/a config :pleroma, :http, proxy_url: {:socks5, :localhost, 9050}' $pleroma_secret + sed -i 's|config :pleroma, :http, proxy_url:|# config :pleroma, :http, proxy_url:|g' $PLEROMA_DIR/config/config.exs + # set registrations open initially sed -i 's|registrations_open:.*|registrations_open: true,|g' $PLEROMA_DIR/config/config.exs sed -i 's|"registrationOpen":.*|"registrationOpen": true,|g' $PLEROMA_DIR/priv/static/static/config.json diff --git a/src/freedombone-app-searx b/src/freedombone-app-searx index a72a11cf..66fc4aaa 100755 --- a/src/freedombone-app-searx +++ b/src/freedombone-app-searx @@ -35,6 +35,7 @@ SHOW_ICANN_ADDRESS_ON_ABOUT=0 SEARX_REPO="https://github.com/asciimoo/searx" SEARX_COMMIT='80460be8f69cea5f15c9d5ddbb63e4e48fde2dd0' SEARX_PATH=/etc +SEARX_PORT=8888 SEARX_ONION_PORT=8094 SEARX_ONION_HOSTNAME= SEARX_LOGIN_TEXT=$"Search engine login" @@ -258,7 +259,7 @@ function create_searx_config { echo ' language : "all"'; echo ''; echo 'server:'; - echo ' port : 8888'; + echo " port : ${SEARX_PORT}"; echo ' bind_address : "127.0.0.1" # address to listen on'; echo " secret_key : \"${SEARX_SECRET_KEY}\""; echo " base_url : http://${SEARX_ONION_HOSTNAME}/"; @@ -926,6 +927,7 @@ function install_searx { set_completion_param "searx commit" "$SEARX_COMMIT" # create an onion service + USE_V2_ONION_ADDRESS=1 SEARX_ONION_HOSTNAME=$(add_onion_service searx 80 ${SEARX_ONION_PORT}) # an unprivileged user to run as @@ -965,7 +967,7 @@ function install_searx { echo ' location / {'; } >> /etc/nginx/sites-available/searx function_check nginx_limits nginx_limits searx '1M' - { echo ' proxy_pass http://localhost:8888;'; + { echo " proxy_pass http://localhost:${SEARX_PORT};"; echo " #auth_basic \"${SEARX_LOGIN_TEXT}\";"; echo ' #auth_basic_user_file /etc/nginx/.htpasswd;'; echo ' }'; diff --git a/src/freedombone-controlpanel b/src/freedombone-controlpanel index a8da60a7..72b96d14 100755 --- a/src/freedombone-controlpanel +++ b/src/freedombone-controlpanel @@ -232,6 +232,12 @@ function show_domains { W+=("IPv6" "${ipv6_address}") fi + if [ -f /etc/ssh/ssh_host_rsa_key.pub ]; then + W+=("ssh rsa sha256" "$(awk '{print $2}' /etc/ssh/ssh_host_rsa_key.pub | base64 -d | sha256sum -b | awk '{print $1}' | xxd -r -p | base64 | sed 's|=||g')") + fi + if [ -f /etc/ssh/ssh_host_ed25519_key.pub ]; then + W+=("ssh ed25519 sha256" "$(awk '{print $2}' /etc/ssh/ssh_host_ed25519_key.pub | base64 -d | sha256sum -b | awk '{print $1}' | xxd -r -p | base64 | sed 's|=||g')") + fi if grep -q "ssh onion domain" "$COMPLETION_FILE"; then domain_onion=$(grep 'ssh onion domain' "${COMPLETION_FILE}" | awk -F ':' '{print $2}') @@ -362,26 +368,10 @@ function show_tahoelafs { echo '' } -function show_ssh_public_key { - echo $'SSH Public Keys' - echo '===============' - echo '' - get_ssh_server_key - echo '' - echo '' -} - function show_about { detect_apps get_apps_installed_names - - #clear - #echo "==== ${PROJECT_NAME} version ${VERSION} ($DEBIAN_VERSION) ====" - #echo '' - #show_ssh_public_key show_domains - #show_users - #any_key } function select_user { @@ -1808,13 +1798,17 @@ function performance_benchmarks { if [ ! -f /sbin/hdparm ]; then apt-get -yq install hdparm - clear fi test_drive=/dev/sda1 - if [ -f /dev/mmcblk0 ]; then - test_drive=/dev/mmcblk0 + if ! ls $test_drive; then + if ls /dev/mmcblk0p2; then + test_drive=/dev/mmcblk0p2 + else + return + fi fi + clear echo '' echo $"Testing read speed of drive $test_drive" hdparm -tT $test_drive diff --git a/src/freedombone-image b/src/freedombone-image index 020b4a88..04c96075 100755 --- a/src/freedombone-image +++ b/src/freedombone-image @@ -153,6 +153,10 @@ MULTIPATH_TOOLS_REPO="https://aur.archlinux.org/multipath-tools.git" MBR_REPO="https://aur.archlinux.org/mbr.git" CLIAPP_REPO="git://git.liw.fi/cliapp" +# Whether to use a SATA drive and if so what its device/partition name is +# eg. sda2 +EXTERNAL_DRIVE= + function image_setup { setup_type=$1 @@ -453,6 +457,10 @@ do shift LOCAL_NAME="$1" ;; + --sata|--hdd) + shift + EXTERNAL_DRIVE="$1" + ;; *) # unknown option ;; @@ -533,6 +541,10 @@ if [[ $ONION_ONLY != "no" ]]; then IMAGE_NAME=$'onion' fi +if [ "$EXTERNAL_DRIVE" ]; then + IMAGE_NAME=$'sata' +fi + if [[ $VARIANT == 'mesh' ]]; then IMAGE_NAME=$'mesh' # typically not much disk space is needed for a mesh node @@ -601,6 +613,7 @@ make "$IMAGE_TYPE" \ INSECURE="$INSECURE" \ AMNESIC="$AMNESIC" \ SOCIALINSTANCE="$SOCIALINSTANCE" \ + EXTERNAL_DRIVE="$EXTERNAL_DRIVE" \ LOCAL_NAME="$LOCAL_NAME" # shellcheck disable=SC2181 diff --git a/src/freedombone-image-customise b/src/freedombone-image-customise index edbfbc78..8753bdcb 100755 --- a/src/freedombone-image-customise +++ b/src/freedombone-image-customise @@ -141,6 +141,10 @@ BMX7_COMMIT='0a82c7c10fef44b259b35e77ab33632aa132d219' PATH=/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin:/bin:/sbin +# Whether to use a SATA drive and if so what its device/partition name is +# eg. sda2 +EXTERNAL_DRIVE= + configure_backports() { echo "deb http://${DEBIAN_REPO}/debian/ ${DEBIAN_VERSION}-backports main" >> "$rootdir/etc/apt/sources.list" } diff --git a/src/freedombone-image-hardware-setup b/src/freedombone-image-hardware-setup index c63978c0..ea297faa 100755 --- a/src/freedombone-image-hardware-setup +++ b/src/freedombone-image-hardware-setup @@ -155,6 +155,10 @@ beaglebone_repack_kernel() { a20_setup_boot() { dtb="$1" + a20_root_device='mmcblk0p2' + if [ "$2" ]; then + a20_root_device="$2" + fi # Setup boot.cmd if grep -q btrfs /etc/fstab ; then @@ -173,7 +177,7 @@ a20_setup_boot() { setenv mmcdev 0 setenv mmcpart 1 -setenv mmcroot /dev/mmcblk0p2 ro +setenv mmcroot /dev/${a20_root_device} ro setenv mmcrootfstype $fstype rootwait fixrtc setenv mmcrootflags subvol=@ @@ -239,27 +243,27 @@ case "$MACHINE" in enable_serial_console ttyO0 ;; cubietruck) - a20_setup_boot sun7i-a20-cubietruck.dtb + a20_setup_boot sun7i-a20-cubietruck.dtb "$EXTERNAL_DRIVE" enable_serial_console ttyS0 ;; a20-olinuxino-lime) - a20_setup_boot sun7i-a20-olinuxino-lime.dtb + a20_setup_boot sun7i-a20-olinuxino-lime.dtb "$EXTERNAL_DRIVE" enable_serial_console ttyS0 ;; a20-olinuxino-lime2) - a20_setup_boot sun7i-a20-olinuxino-lime2.dtb + a20_setup_boot sun7i-a20-olinuxino-lime2.dtb "$EXTERNAL_DRIVE" enable_serial_console ttyS0 ;; a20-olinuxino-micro) - a20_setup_boot sun7i-a20-olinuxino-micro.dtb + a20_setup_boot sun7i-a20-olinuxino-micro.dtb "$EXTERNAL_DRIVE" enable_serial_console ttyS0 ;; cubieboard2) - a20_setup_boot sun7i-a20-cubieboard2.dtb + a20_setup_boot sun7i-a20-cubieboard2.dtb "$EXTERNAL_DRIVE" enable_serial_console ttyS0 ;; pcduino3) - a20_setup_boot sun7i-a20-pcduino3.dtb + a20_setup_boot sun7i-a20-pcduino3.dtb "$EXTERNAL_DRIVE" enable_serial_console ttyS0 ;; esac diff --git a/src/freedombone-image-make b/src/freedombone-image-make index 899fe691..0890fe18 100755 --- a/src/freedombone-image-make +++ b/src/freedombone-image-make @@ -77,6 +77,7 @@ export INSECURE export AMNESIC export SOCIALINSTANCE export LOCAL_NAME +export EXTERNAL_DRIVE # Locate vmdebootstrap program fetched in Makefile basedir=`pwd` @@ -101,7 +102,7 @@ a20_pkgs="linux-image-armmp-lpae u-boot-tools u-boot u-boot-sunxi" # Packages needed for self-hosted development dev_pkgs="build-essential devscripts make man-db emacs org-mode git mercurial" -echo Building "$MACHINE" "$PROJECT_NAME" for "$ARCHITECTURE". +echo Building "$MACHINE" "$PROJECT_NAME" for "$ARCHITECTURE" "$EXTERNAL_DRIVE" case "$MACHINE" in beaglebone) @@ -225,6 +226,7 @@ sed -i "s|INSECURE=.*|INSECURE=\"${INSECURE}\"|g" "$TEMP_CUSTOMISE3" sed -i "s|AMNESIC=.*|AMNESIC=\"${AMNESIC}\"|g" "$TEMP_CUSTOMISE3" sed -i "s|SOCIALINSTANCE=.*|SOCIALINSTANCE=\"${SOCIALINSTANCE}\"|g" "$TEMP_CUSTOMISE3" sed -i "s|LOCAL_NAME=.*|LOCAL_NAME=\"${LOCAL_NAME}\"|g" "$TEMP_CUSTOMISE3" +sed -i "s|EXTERNAL_DRIVE=.*|EXTERNAL_DRIVE=\"${EXTERNAL_DRIVE}\"|g" "$TEMP_CUSTOMISE3" sed -i 's|#!/bin/bash||g' "$TEMP_CUSTOMISE3" cat $TEMP_CUSTOMISE2 $TEMP_CUSTOMISE3 > $TEMP_CUSTOMISE4 @@ -254,6 +256,7 @@ sudo -H \ ARCHITECTURE="$ARCHITECTURE" \ SOURCE="$SOURCE" \ CUSTOM_SETUP="$CUSTOM_SETUP" \ + EXTERNAL_DRIVE="$EXTERNAL_DRIVE" \ $VMDEBOOTSTRAP \ --log "$(dirname "$IMAGE")/${PROJECT_NAME}.log" \ --log-level debug \ diff --git a/src/freedombone-utils-web b/src/freedombone-utils-web index feac9028..55799cf7 100755 --- a/src/freedombone-utils-web +++ b/src/freedombone-utils-web @@ -88,11 +88,11 @@ function nginx_limits { max_body=$2 fi filename=/etc/nginx/sites-available/$domain_name - { echo " client_max_body_size ${max_body};"; - echo ' client_body_buffer_size 128k;'; + { echo " client_max_body_size ${max_body};"; + echo ' client_body_buffer_size 128k;'; echo ''; - echo ' limit_conn conn_limit_per_ip 10;'; - echo ' limit_req zone=req_limit_per_ip burst=10 nodelay;'; + echo ' limit_conn conn_limit_per_ip 10;'; + echo ' limit_req zone=req_limit_per_ip burst=10 nodelay;'; echo ''; } >> "$filename" } diff --git a/website/EN/faq.html b/website/EN/faq.html index 87688caa..93a60fa0 100644 --- a/website/EN/faq.html +++ b/website/EN/faq.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + ‎ @@ -262,155 +262,159 @@ for the JavaScript code in this tag. -What applications are supported? +What applications are supported? -I don't have a static IP address. Can I still install this system? +I don't have a static IP address. Can I still install this system? -What are the best microSD cards to use? +What are the best microSD cards to use? -Why Freedombone and not FreedomBox? +On a single board computer can I boot from an external SSD or hard drive? -Why not support building images for Raspberry Pi? +Why Freedombone and not FreedomBox? -Why use Tor? I've heard it's used by bad people +Why not support building images for Raspberry Pi? -How is Tor integrated with Freedombone? +Why use Tor? I've heard it's used by bad people -Can I add a clearnet domain to an onion build? +How is Tor integrated with Freedombone? -Why use Github? +Can I add a clearnet domain to an onion build? -After using nmap or other scanning tool I can no longer log in +Why use Github? -Should I upload my GPG keys to keybase.io? +After using nmap or other scanning tool I can no longer log in -Keys and emails should not be stored on servers. Why do you do that? +Should I upload my GPG keys to keybase.io? -Why can't I access my .onion site with a Tor browser? +Keys and emails should not be stored on servers. Why do you do that? -What is the best hardware to run this system on? +Why can't I access my .onion site with a Tor browser? -Can I add more users to the system? +What is the best hardware to run this system on? -Why not use Signal for mobile chat? +Can I add more users to the system? -What is the most secure chat app to use on mobile? +Why not use Signal for mobile chat? -How do I remove a user from the system? +What is the most secure chat app to use on mobile? -Why is logging for web sites turned off by default? +How do I remove a user from the system? -How do I reset the tripwire? +Why is logging for web sites turned off by default? -Is metadata protected? +How do I reset the tripwire? -How do I create email processing rules? +Is metadata protected? -Why isn't dynamic DNS working? +How do I create email processing rules? -How do I change my encryption settings? +Why isn't dynamic DNS working? -How do I get a domain name? +How do I change my encryption settings? -How do I get a "real" SSL/TLS/HTTPS certificate? +How do I get a domain name? -How do I renew a Let's Encrypt certificate? +How do I get a "real" SSL/TLS/HTTPS certificate? -I tried to renew a Let's Encrypt certificate and it failed. What should I do? +How do I renew a Let's Encrypt certificate? -Why not use the services of $company instead? They took the Seppuku pledge +I tried to renew a Let's Encrypt certificate and it failed. What should I do? -Why does my email keep getting rejected as spam by Gmail/etc? +Why not use the services of $company instead? They took the Seppuku pledge -Tor is censored/blocked in my area. What can I do? +Why does my email keep getting rejected as spam by Gmail/etc? -I want to block a particular domain from getting its content into my social network sites +Tor is censored/blocked in my area. What can I do? -The mesh system doesn't boot from USB drive +I want to block a particular domain from getting its content into my social network sites -Mesh system doesn't connect to the network +The mesh system doesn't boot from USB drive + + + +Mesh system doesn't connect to the network -
-

What applications are supported?

-
+
+

What applications are supported?

+

See here for the complete list of apps. In addition to those as part of the base install you get an email server.

-
-

I don't have a static IP address. Can I still install this system?

-
+
+

I don't have a static IP address. Can I still install this system?

+

Yes. The minimum requirements are to have some hardware that you can install Debian onto and also that you have administrator access to your internet router so that you can forward ports to the system which has Freedombone installed.

@@ -420,25 +424,58 @@ The lack of a static IP address can be worked around by using a dynamic DNS serv

-
-

What are the best microSD cards to use?

-
+
+

What are the best microSD cards to use?

+

There can be big differences in the performance of microSD cards, and the cheaper ones are almost invariably terrible and/or unusable. Sandisk and Samsung currently appear to be the better brands. You can find some performance benchmarks here. However, benchmarks like this only give a very rough idea of performance and they can vary significantly between individual cards even within the same brand.

-
-

Why Freedombone and not FreedomBox?

-
+
+

On a single board computer can I boot from an external SSD or hard drive?

+
+

+Some single board computers, such as Cubieboards or OLinuxino, have a SATA socket on them which enables an external drive to be connected. This is usually intended for extra file storage, but it is also possible to run the operating system from an external drive. This can have the advantage of significantly increasing the read/write performance and your apps will appear to run more quickly. +

+ +

+Typically a microSD read speed is 10-30MB/s. An SSD or hard drive can be 100MB/s or more, so that's a big potential gain. +

+ +

+Single board computers usually don't have the capability of booting directly from an external drive, but what you can do is boot from a partition on a microSD drive, which then runs the main filesystem (the rootfs) from the external drive. +

+ +

+To create an image suitable for running from an SSD or hard drive use the –sata option, such as: +

+ +
+
freedombone-image -t cubieboard2 --sata sda2
+
+
+ +

+Note that the sata option should be set to point to the second partition on the drive, which is normally sda2. +

+ +

+When the image is created then use the dd command to copy it both to a microSD card and to the SSD or hard drive. Plug them both into the board and it should then boot and use the external drive. +

+
+
+
+

Why Freedombone and not FreedomBox?

+

When the project began in late 2013 the FreedomBox project seemed to be going nowhere, and was only designed to work with the DreamPlug hardware. There was some new hardware out - the Beaglebone Black - which could run Debian and was also a free hardware design so seemed more appropriate. Hence the name "Freedombone", being like FreedomBox but on a Beaglebone. There are some similarities and differences between the two projects:

-
-

Similarities

-
+
+

Similarities

+
  • Uses freedom-maker and vmdebootstrap to build debian images
  • Supports the use of Tor onion addresses to access websites
    • @@ -452,9 +489,9 @@ When the project began in late 2013 the FreedomBox project seemed to be going no
-
-

Differences

-
+
+

Differences

+
  • FreedomBox is a Debian pure blend. Freedombone is not
  • Freedombone only supports Free Software. FreedomBox includes some closed binary boot blobs for certain ARM boards
    • @@ -469,9 +506,9 @@ When the project began in late 2013 the FreedomBox project seemed to be going no
-
-

Why not support building images for Raspberry Pi?

-
+
+

Why not support building images for Raspberry Pi?

+

The FreedomBox project supports Raspberry Pi builds, and the image build system for Freedombone is based on the same system. However, although the Raspberry Pi can run a version of Debian it requires a closed proprietary blob in order to boot the hardware. Who knows what that blob might contain or what exploits it could facilitate. From an adversarial point of view if you were trying to deliver "bulk equipment interference" then it doesn't get any better than piggybacking on something which has control of the boot process, and hence all subsequently run processes.

@@ -481,9 +518,9 @@ So although the Raspberry Pi is cheap and hugely popular it's not supported by t

-
-

Why use Tor? I've heard it's used by bad people

-
+
+

Why use Tor? I've heard it's used by bad people

+

Years ago Tor was usually depicted in the mainstream media as something scary inhabited by cyberterrorists and other bad cybers, but today to a large extent Tor is accepted as just another way of routing data in a network. Depending upon where you live there may still be some amount of fearmongering about Tor, but it now seems clear that the trajectory is towards general acceptance.

@@ -504,9 +541,9 @@ On the negative side it's a complex system which is not fully decentralized.

-
-

How is Tor integrated with Freedombone?

-
+
+

How is Tor integrated with Freedombone?

+

Within this project Tor is used more to provide accessibility than the anonymity factor for which Tor is better known. The onion address system provides a way of being able to access sites even if you don't own a conventional domain name or don't have administrator access to your local internet router to be able to do port forwarding.

@@ -524,17 +561,17 @@ Even if you're running the "onion only" build, this only means that sites are ac

-
-

Can I add a clearnet domain to an onion build?

-
+
+

Can I add a clearnet domain to an onion build?

+

You could if you manually edited the relevant nginx configuration files and installed some dynamic DNS system yourself. If you already have sysadmin knowledge then that's probably not too hard. But the builds created with the onion-addresses-only option aren't really intended to support access via clearnet domains.

-
-

Why use Github?

-
+
+

Why use Github?

+

Github is paradoxically a centralized, closed and proprietary system which happens to mostly host free and open source projects. Up until now it has been relatively benign, but at some point in the name of "growth" it will likely start becoming more evil, or just become like SourceForge - which was also once much loved by FOSS developers, but turned into a den of malvertizing.

@@ -552,17 +589,17 @@ Currently many of the repositories used for applications which are not yet packa

-
-

After using nmap or other scanning tool I can no longer log in

-
+
+

After using nmap or other scanning tool I can no longer log in

+

This system tries to block port scanners. Any other system trying to scan for open ports will have their IP address added to a temporary block list for 24 hours.

-
-

Should I upload my GPG keys to keybase.io?

-
+
+

Should I upload my GPG keys to keybase.io?

+

It's not recommended unless there exists some compelling reason for you to be on there. That site asks users to upload the private keys, and even if the keys are client side encrypted with a passphrase there's always the chance that there will be a data leak in future and letter agencies will then have a full time opportunity to crack the passphrases.

@@ -572,9 +609,9 @@ Saying something resembling "only noobs will use crackable private key passph

-
-

Keys and emails should not be stored on servers. Why do you do that?

-
+
+

Keys and emails should not be stored on servers. Why do you do that?

+

Ordinarily this is good advice. However, the threat model for a device in your home is different from the one for a generic server in a massive warehouse. Compare and contrast:

@@ -632,9 +669,9 @@ In the home environment a box with a good firewall and no GUI components install
-
-

Why can't I access my .onion site with a Tor browser?

-
+
+

Why can't I access my .onion site with a Tor browser?

+

Probably you need to add the site to the NoScript whitelist. Typically click/press on the noscript icon (or select from the menu on mobile) then select whitelist and add the site URL. You may also need to disable HTTPS Everywhere when using onion addresses, which don't use https.

@@ -644,9 +681,9 @@ Another factor to be aware of is that it can take a while for the onion address

-
-

What is the best hardware to run this system on?

-
+
+

What is the best hardware to run this system on?

+

It was originally designed to run on the Beaglebone Black, but that should be regarded as the most minimal system, because it's single core and has by today's standards a small amount of memory. Obviously the more powerful the hardware is the faster things like web pages (blog, social networking, etc) will be served but the more electricity such a system will require if you're running it 24/7. A good compromise between performance and energy consumption is something like an old netbook. The battery of an old netbook or laptop even gives you UPS capability to keep the system going during brief power outages or cable re-arrangements, and that means using full disk encryption on the server also becomes more practical.

@@ -656,9 +693,9 @@ It was originally designed to run on the Beaglebone Black, but that should be re

-
-

Can I add more users to the system?

-
+
+

Can I add more users to the system?

+

Yes. Freedombone can support a small number of users, for a "friends and family" type of home installation. This gives them access to an email account, XMPP, SIP phone and the blog (depending on whether the variant which you installed includes those).

@@ -681,9 +718,9 @@ Another point is that Freedombone installations are not intended to support many

-
-

Why not use Signal for mobile chat?

-
+
+

Why not use Signal for mobile chat?

+

Celebrities recommend Signal. It's Free Software so it must be good, right?

@@ -706,9 +743,9 @@ To give credit where it's due Signal is good, but it could be a lot better. The

-
-

What is the most secure chat app to use on mobile?

-
+
+

What is the most secure chat app to use on mobile?

+

On mobile there are various options. The apps which are likely to be most secure are ones which have end-to-end encryption enabled by default and which can also be onion routed via Orbot. End-to-end encryption secures the content of the message and onion routing obscures the metadata, making it hard for a passive adversary to know who is communicating with who.

@@ -718,13 +755,13 @@ The current safest way to chat is to use Conv

-There are many other fashionable chat apps with end-to-end security, but often they are closed source, have a single central server or can't be onion routed. It's also important to remember that closed source chat apps should be assumed to be untrustworthy, since their security cannot be independently verified. +There are many other fashionable chat apps with end-to-end security, but often they are closed source, have a single central server or can't be onion routed. It's also important to remember that closed source chat apps should be assumed to be untrustworthy, since their security cannot be independently verified.

-
-

How do I remove a user from the system?

-
+
+

How do I remove a user from the system?

+

To remove a user:

@@ -739,9 +776,9 @@ Select Administrator controls then Manage Users and then Delete

-
-

Why is logging for web sites turned off by default?

-
+
+

Why is logging for web sites turned off by default?

+

If you're making profits out of the logs by running large server warehouses and then data mining what users click on - as is the business model of well known internet companies - then logging everything makes total sense. However, if you're running a home server then logging really only makes sense if you're trying to diagnose some specific problem with the system, and outside of that context logging everything becomes more of a liability than an asset.

@@ -755,9 +792,9 @@ On the Freedombone system web logs containing IP addresses are turned off by def

-
-

How do I reset the tripwire?

-
+
+

How do I reset the tripwire?

+

The tripwire will be automatically reset once per week. If you want to reset it earlier then do the following:

@@ -772,9 +809,9 @@ Select Administrator controls then "reset tripwire" using cursors and spa

-
-

Is metadata protected?

-
+
+

Is metadata protected?

+

"We kill people based on metadata" @@ -790,9 +827,9 @@ Even when using Freedombone metadata analysis by third parties is still possible

-
-

How do I create email processing rules?

-
+
+

How do I create email processing rules?

+
ssh username@domainname -p 2222
@@ -848,9 +885,9 @@ Spamassassin is also available and within Mutt you can use the S (shift+s) key t

-
-

Why isn't dynamic DNS working?

-
+
+

Why isn't dynamic DNS working?

+

If you run the command:

@@ -873,9 +910,9 @@ https://www.privateinternetaccess.com/pages/whats-my-ip/
-
-

How do I change my encryption settings?

-
+
+

How do I change my encryption settings?

+

Suppose that some new encryption vulnerability has been announced and that you need to change your encryption settings. Maybe an algorithm thought to be secure is now no longer so and you need to remove it. You can change your settings by doing the following:

@@ -890,9 +927,9 @@ Select Administrator controls then select Security Settings. You w

-
-

How do I get a domain name?

-
+
+

How do I get a domain name?

+

Suppose that you have bought a domain name (rather than using a free subdomain on freedns) and you want to use that instead.

@@ -956,9 +993,9 @@ You should now be able to send an email from postmaster@mynewdomainname a
-
-

How do I get a "real" SSL/TLS/HTTPS certificate?

-
+
+

How do I get a "real" SSL/TLS/HTTPS certificate?

+

If you did the full install or selected the social variant then the system will have tried to obtain a Let's Encrypt certificate automatically during the install process. If this failed for any reason, or if you have created a new site which you need a certificate for then do the following:

@@ -977,9 +1014,9 @@ One thing to be aware of is that Let's Encrypt doesn't support many dynamic DNS

-
-

How do I renew a Let's Encrypt certificate?

-
+
+

How do I renew a Let's Encrypt certificate?

+

Normally certificates will be automatically renewed once per month, so you don't need to be concerned about it. If anything goes wrong with the automatic renewal then you should receive a warning email.

@@ -998,9 +1035,9 @@ Select Administrator controls then Security settings then Renew

-
-

I tried to renew a Let's Encrypt certificate and it failed. What should I do?

-
+
+

I tried to renew a Let's Encrypt certificate and it failed. What should I do?

+

Most likely it's because Let's Encrypt doesn't support your particular domain or subdomain. Currently free subdomains tend not to work. You'll need to buy a domain name, link it to your dynamic DNS account and then do:

@@ -1015,17 +1052,17 @@ Select Administrator controls then Security settings then Creat

-
-

Why not use the services of $company instead? They took the Seppuku pledge

-
+
+

Why not use the services of $company instead? They took the Seppuku pledge

+

That pledge is utterly worthless. Years ago people trusted Google in the same sort of way, because they promised not be be evil and because a lot of the engineers working for them seemed like honest types who were "on our side". Post-nymwars and post-PRISM we know exactly how much Google cared about the privacy and security of its users. But Google is only one particular example. In general don't trust pledges made by companies, even if the people running them seem really sincere.

-
-

Why does my email keep getting rejected as spam by Gmail/etc?

-
+
+

Why does my email keep getting rejected as spam by Gmail/etc?

+

Welcome to the world of email. Email is really the archetypal decentralized service, developed during the early days of the internet. In principle anyone can run an email server, and that's exactly what you're doing with Freedombone. Email is very useful, but it has a big problem, and that's that the protocols are totally insecure. That made it easy for spammers to do their thing, and in response highly elaborate spam filtering and blocking systems were developed. Chances are that your emails are being blocked in this way. Sometimes the blocking is so indisciminate that entire countries are excluded. What can you do about it? Unless you control the block list at the receiving end you may not be able to do much unless you can find an email proxy server which is trusted by the receiving server.

@@ -1056,9 +1093,9 @@ So the situation with email presently is pretty bad, and there's a clear selecti

-
-

Tor is censored/blocked in my area. What can I do?

-
+
+

Tor is censored/blocked in my area. What can I do?

+

If you can find some details for an obfs4 Tor bridge (its IP address, port number and key or nickname) then you can set up the system to use it to connect to the Tor network. Unlike relay nodes the IP addresses for bridges are not public information and so can't be easily known and added to block lists by authoritarian regimes or over-zealous ISPs.

@@ -1083,9 +1120,9 @@ You can also set your system to act as a Tor bridge, although this is not recomm
-
-

I want to block a particular domain from getting its content into my social network sites

-
+
+

I want to block a particular domain from getting its content into my social network sites

+

If you're being pestered by some domain which contains bad/illegal/harrassing content or irritating users you can block domains at the firewall level. Go to the administrator control panel and select domain blocking. You can then block, unblock and view the list of blocked domains.

@@ -1100,9 +1137,9 @@ Select Administrator controls then Domain blocking.
-
-

The mesh system doesn't boot from USB drive

-
+
+

The mesh system doesn't boot from USB drive

+

If the system doesn't boot and reports an error which includes /dev/mapper/loop0p1 then reboot with Ctrl-Alt-Del and when you see the grub menu press e and manually change /dev/mapper/loop0p1 to /dev/sdb1, then press Ctrl-x. If that doesn't work then reboot and try /dev/sdc1 instead.

@@ -1113,9 +1150,9 @@ After the system has booted successfully the problem should resolve itself on su
-
-

Mesh system doesn't connect to the network

-
+
+

Mesh system doesn't connect to the network

+

Sometimes after boot the mesh system won't connect to other peers on the network. If this happens select the network restart icon and enter the password, which by default is just "freedombone". Wait for a few minutes to see if it connects.

diff --git a/website/EN/homeserver.html b/website/EN/homeserver.html index 1412dd0b..ce335577 100644 --- a/website/EN/homeserver.html +++ b/website/EN/homeserver.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + ‎ @@ -243,9 +243,9 @@ for the JavaScript code in this tag.
-
-

Home Server

-
+
+

Home Server

+

The quickest way to get started is as follows. You will need to be running a Debian based system (version 8 or later), have an old but still working laptop or netbook which you can use as a server, and 8GB or larger USB thumb drive and an ethernet cable to connect the laptop to your internet router.

@@ -420,7 +420,7 @@ Then select About. You'll see a list of sites and their onion addresses.
-

control_panel_about.jpg +

control_panel_about.jpg

diff --git a/website/EN/mobile.html b/website/EN/mobile.html index 4eb61faa..6d2b7c30 100644 --- a/website/EN/mobile.html +++ b/website/EN/mobile.html @@ -3,26 +3,33 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - - - - - - + + +‎ + + + - + @@ -97,7 +189,7 @@ @licstart The following is the entire license notice for the JavaScript code in this tag. -Copyright (C) 2012-2013 Free Software Foundation, Inc. +Copyright (C) 2012-2017 Free Software Foundation, Inc. The JavaScript code in this tag is free software: you can redistribute it and/or modify it under the terms of the GNU @@ -144,55 +236,19 @@ for the JavaScript code in this tag.
-

logo.png

-
-

Mobile

-

Mobile phones are insecure devices, but they're regarded as being so essential to modern life that telling people not to use them isn't a viable option. Here are some recommendations on setting up a mobile phone (aka "smartphone") to work with Freedombone.

-
-

- <center> - <table style="width:80%; border:0"> - <tr> - <td><center><b><h3>Open</h3></b><br>Use a free and open source operating system. Open means more trustworthy</center></td> - <td><center><b><h3>Remove</h3></b><br>If there are any proprietary apps then remove or deactivate them</center></td> - </tr> - <tr> - <td><center><b><h3>Encrypt</h3></b><br>Make sure your phone is encrypted with a password which isn't easy to guess</center></td> - <td><center><b><h3>Apps</h3></b><br>Use F-droid to install new apps</center></td> - </tr> - <tr> - <td><center><b><h3>Lock</h3></b><br>Enable a lock screen with a maximum number of password guesses</center></td> - <td><center><b><h3>Onion</h3></b><br>Onion route your connections to avoid bulk metadata collection</center></td> - </tr> - <tr> - <td><center><b><h3>Email</h3></b><br>Access webmail in a browser</center></td> - <td><center><b><h3>Services</h3></b><br>Connect to the Freedombone services</center></td> - </tr> - <tr> - <td><center><b><h3>Battery</h3></b><br>Avoid battery-eating apps and disable some optimisations</center></td> - <td><center><b><h3>Block</h3></b><br>Prevent access to know bad domains</center></td> - </tr> -</table> -</center> -

- -
-
-
- -
-

Open

-
+
+

Open

+

Use a Linux based phone operating system. Typically this will mean Android, but could also mean LineageOS or Replicant. LineageOS is the most preferable, because you can usually get an up to date image with a recent kernel which will give you better security against exploits. If you're buying a phone then look for a model which is supported by LineageOS. Replicant is the most free (as in freedom) but only runs on a small number of phone models. If you have a phone which runs a full GNU/Linux system then that's fantastic, and you can probably use it in much the same way as a desktop system and the rest of the advice on this page won't apply. If you don't have a phone capable of running a Linux based operating system then consider selling, giving away or bartering your existing one.

@@ -207,27 +263,27 @@ In the end it comes down to the fact that if the source code for the device c
-
-

Remove

-
+
+

Remove

+

So maybe you're running Android and the phone came with some apps already installed. Almost certainly they'll be proprietary. Go to Settings/Apps and then uninstall or deactivate any apps which you really don't need. Mostly preinstalled apps are intended to send your data to companies who will then sell it to advertisers or governments under the business model of surveillance capital. It's not a good idea to get caught up in that, and to avoid becoming addicted to apps which are surveilling you without consent or installing spyware in the background without your knowledge.

-
-

Encrypt

-
+
+

Encrypt

+

Encrypt your phone. This can usually be done via Settings/Security and you may need to fully charge the phone first. Encryption means that if you lose your phone or it gets stolen then there is less chance that anyone who picks it up will get access to your data, photos and so on.

-
-

Apps

-
+
+

Apps

+

Installing F-droid and only adding any new apps via F-droid will ensure that you are always using free and open source software. Open source is not a panacea, since bugs can and do still occur, but it will help you to avoid the worst security and privacy pitfalls.

@@ -238,18 +294,18 @@ Avoid using the Open Whisper Systems Signal app if you can, no matter what "expe
-
-

Lock

-
+
+

Lock

+

Add a lock screen, preferably with a password which is not easy for other people to guess or for quicker access with a PIN number. Install an app called Locker, activate it and set the maximum number of password guesses to ten (or whatever you feel comfortable with). If bad people get hold of your phone then they may try to brute force your lock screen password or PIN (i.e. automatically trying millions of common word and number combinations) and the locker app will prevent them from succeeding by resetting the phone back to its factory default condition and wiping the data.

-
-

Onion

-
+
+

Onion

+

Both governments and corporations want to compile matadata dossiers about you. Who you communicated with, when and how often. They want this so that they can data mine, simulate, predict and then ultimately influence (sometimes also called "nudge") your actions and preferences in the directions they prefer. By routing your connections through a number of proxy servers (Tor routers) you can make it perhaps not theoretically impossible but at least very hard for them to have a complete and accurate list of who your friends are, your religion, politics, likely health issues, sexual orientation and what news sites or books you read.

@@ -260,26 +316,26 @@ In F-droid under the repositories menu you can enable the guardian pro
-
-

Email

-
+
+

Email

+

The easiest way to access email is by installing the Mailpile app. This keeps your GPG keys off of possibly insecure mobile devices but still enables encrypted email communications in an easy way. You can use K9 mail if you prefer, but that will require installing OpenKeychain and having your GPG keys on the device, which is a lot more risky.

-
-

Services

-
+
+

Services

+

For information on configuring various apps to work with Freedombone see the apps section. Also see advice on chat apps in the FAQ.

-
-

Battery

-
+
+

Battery

+

Even with free software apps it's not difficult to get into a situation where your battery doesn't last for long. To maximize battery life access RSS feeds via the onion-based mobile reader within a Tor-compatible browser and not from a locally installed RSS app.

@@ -298,9 +354,9 @@ It's also recommended to disable battery optimisations for Conversations and Orb
-
-

Blocking bad domains

-
+
+

Blocking bad domains

+

You can block known bad domains by editing the /system/etc/hosts file on your device. It is possible to use extensive ad-blocking hosts files used by other ad-blocking systems such as pi-hole, but merely blocking Facebook and Google Analytics will protect you against much of the corporate surveillance which goes on. Even if you don't have a Facebook account this may still be useful since they will still try to create a "ghost profile" of you, so the less data they have the better.

@@ -318,7 +374,6 @@ On your system (not the device) install the android-tools package. For ex

- 
sudo pacman -S android-tools
@@ -328,7 +383,6 @@ Connect the device to your system via a USB cable, then:

- 
adb root
 adb remount
 adb pull /system/etc/hosts
@@ -340,7 +394,6 @@ Now edit the hosts file which was pulled and append:
 

 
 

-
 
127.0.0.1       www.facebook.com
 127.0.0.1       facebook.com
 127.0.0.1       static.ak.fbcdn.net
@@ -365,7 +418,6 @@ Then upload the hosts file back again with:
 

 
 

-
 
adb push hosts /system/etc/hosts
 

 

@@ -374,14 +426,9 @@ Then upload the hosts file back again with:
 Once that's done you may want to set Root access on the device back to Disabled and turn Android debugging off.
 

 
-

-

-<center>
-Return to the <a href="index.html">home page</a>
-</center>
-

-
-

+

+Return to the home page
+