diff --git a/doc/EN/index.org b/doc/EN/index.org index 86f85cc2..ae54ada9 100644 --- a/doc/EN/index.org +++ b/doc/EN/index.org @@ -19,15 +19,14 @@ So you want to run your own internet services? Email, chat, VoIP, web sites, file synchronisation, wikis, blogs, social networks, media hosting, backups, VPN. Freedombone enables you to do all of that in a self-hosted way, where you keep control of your data and it resides in your own home. -[[./homeserver.html][Here's how]]. +A list of other supported ARM boards [[./boards.html][can be found here]], or you can install onto an old laptop or netbook. Some installation instructions for different use cases are: -And here's how [[./beaglebone.html][on a Beaglebone Black]]. A list of other supported ARM boards [[./boards.html][can be found here]]. - -Or you can install [[./debianinstall.html][onto an existing Debian system]]. - -If you have a single board ARM computer which isn't one of the officially supported ones, such as Raspberry Pi, then you may still be able to install [[./armbian.html][Freedombone with Armbian]]. - -Want to make a community mesh network which can either be fully autonomous or connected to the internet? The [[./mesh.html][Freedombone Mesh]] is a wireless solution for networked communication that can be rapidly deployed in temporary, emergency or post-disaster situations where internet access is unavailable or compromised, or used as an infrastructural community service similar to [[https://en.wikipedia.org/wiki/Freifunk][Freifunk]]. + * [[./homeserver.html][Typical installation]] + * Installing [[./beaglebone.html][on a Beaglebone Black]] + * Installing on an [[./debianinstall.html][existing Debian system]] + * Installing [[./armbian.html][on Armbian]], for unsupported ARM boards such as Raspberry Pi + * Creating a dedicated [[./socialinstance.html][fediverse instance]] for a single user or to host a community + * Deploying a [[./mesh.html][mesh network]] which can operate with or without the internet After installation it's possible that you might want some advice on how to run your system and set up apps to work nicely with it. diff --git a/doc/EN/socialinstance.org b/doc/EN/socialinstance.org index 255c5a2f..e84c3a3c 100644 --- a/doc/EN/socialinstance.org +++ b/doc/EN/socialinstance.org @@ -26,10 +26,62 @@ A social instance image allows you to easily set up a fediverse server, which fe The installation process is the same as usual, with the only difference being that on initial setup it will go straight to the domain setup details for your instance. In summary: - * Copy the image to the USB drive, with the *dd* command or other image copying software - * Connect the laptop to your internet router with the ethernet cable - * Boot the laptop from the USB drive - * Forward ports 80 and 443 from your internet router to the laptop - * From another machine ssh into the laptop with *ssh fbone@freedombone.local -p 2222* - * Follow the setup procedure and enter your domain name and dynamic DNS details - * When installation is complete navigate to your domain and register a new user +* Copy the image to the USB drive + +Substitute *sdX* with the device name for your USB drive. + +#+begin_src bash +sudo apt-get install xz-utils wget +wget https://freedombone.net/downloads/current/freedombone-pleroma-amd64.img.xz +wget https://freedombone.net/downloads/current/freedombone-pleroma-amd64.img.xz.sig +gpg --verify freedombone-pleroma-amd64.img.xz.sig +unxz freedombone-pleroma-amd64.img.xz +sudo dd if=/dev/zero of=/dev/sdX bs=1M count=8 +sudo dd bs=1M if=freedombone-pleroma-amd64.img of=/dev/sdX conv=fdatasync +#+end_src + +Also note that if the laptop has a removable SSD drive it's possible to copy the image directly to that if you have enough equipment. + +* Connect the laptop to your internet router + +With the ethernet cable. + +#+BEGIN_CENTER +[[file:images/laptop_router.jpg]] +#+END_CENTER + +* Boot the laptop from the USB drive + +You may need to alter the BIOS settings to get this to work reliably. + +#+BEGIN_CENTER +[[file:images/bios_boot_usb.jpg]] +#+END_CENTER + +* Forward ports 80 (HTTP) and 443 (HTTPS) from your internet router to the laptop + +Log into your internet router using a non-Tor browser (usually it's on an address like 192.168.1.1 or 192.168.1.254). Often port forwarding settings are together with firewall settings. + +#+BEGIN_CENTER +[[file:images/port_forwarding.png]] +#+END_CENTER + +* From another machine ssh into the laptop + +#+begin_src bash +ssh fbone@freedombone.local -p 2222 +#+END_SRC + +Or alternatively you can log in directly on the laptop. The initial username is *fbone* and the password is *freedombone*. You should make sure you write down or copy the new password when it is shown. + +* Follow the setup procedure + +Enter your user details, domain name and dynamic DNS settings. + +* When installation is complete + +Navigate to your domain and register a new user. + +#+BEGIN_CENTER +[[file:images/pleroma_register.jpg]] +#+END_CENTER diff --git a/img/bios_boot_usb.jpg b/img/bios_boot_usb.jpg new file mode 100644 index 00000000..878a243a Binary files /dev/null and b/img/bios_boot_usb.jpg differ diff --git a/img/laptop_router.jpg b/img/laptop_router.jpg new file mode 100644 index 00000000..6511cef9 Binary files /dev/null and b/img/laptop_router.jpg differ diff --git a/img/pleroma_register.jpg b/img/pleroma_register.jpg new file mode 100644 index 00000000..cdfb7752 Binary files /dev/null and b/img/pleroma_register.jpg differ diff --git a/img/port_forwarding.png b/img/port_forwarding.png new file mode 100644 index 00000000..9e16cf00 Binary files /dev/null and b/img/port_forwarding.png differ diff --git a/website/EN/index.html b/website/EN/index.html index 9249cee9..2a9ca125 100644 --- a/website/EN/index.html +++ b/website/EN/index.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,8 +236,7 @@ for the JavaScript code in this tag.
-

-
+

logo.png bbb3.png @@ -167,44 +258,30 @@ So you want to run your own internet services? Email, chat, VoIP, web sites, fil

-Here's how. +A list of other supported ARM boards can be found here, or you can install onto an old laptop or netbook. Some installation instructions for different use cases are:

-

-And here's how on a Beaglebone Black. A list of other supported ARM boards can be found here. -

- -

-Or you can install onto an existing Debian system. -

- -

-If you have a single board ARM computer which isn't one of the officially supported ones, such as Raspberry Pi, then you may still be able to install Freedombone with Armbian. -

- -

-Want to make a community mesh network which can either be fully autonomous or connected to the internet? The Freedombone Mesh is a wireless solution for networked communication that can be rapidly deployed in temporary, emergency or post-disaster situations where internet access is unavailable or compromised, or used as an infrastructural community service similar to Freifunk. -

+

After installation it's possible that you might want some advice on how to run your system and set up apps to work nicely with it.

@@ -216,7 +293,7 @@ If you find bugs, or want to add a new app to this system see the available here.

-
+

This site can also be accessed via a Tor browser at http://yjxlc3imv7obva4grjae6u3qw527koaytrgjgdp364hmthrst3jodiid.onion. This documentation is under the GNU Free Documentation License version 1.3

diff --git a/website/EN/socialinstance.html b/website/EN/socialinstance.html index bfefe188..dcedad2f 100644 --- a/website/EN/socialinstance.html +++ b/website/EN/socialinstance.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + ‎ @@ -264,15 +264,120 @@ A social instance image allows you to easily set up a fediverse server, which fe The installation process is the same as usual, with the only difference being that on initial setup it will go straight to the domain setup details for your instance. In summary:

-
    -
  • Copy the image to the USB drive, with the dd command or other image copying software
    • -
  • Connect the laptop to your internet router with the ethernet cable
    • -
  • Boot the laptop from the USB drive
    • -
  • Forward ports 80 and 443 from your internet router to the laptop
    • -
  • From another machine ssh into the laptop with ssh fbone@freedombone.local -p 2222
    • -
  • Follow the setup procedure and enter your domain name and dynamic DNS details
    • -
  • When installation is complete navigate to your domain and register a new user
    • -
+
+

Copy the image to the USB drive

+
+

+Substitute sdX with the device name for your USB drive. +

+ +
+
sudo apt-get install xz-utils wget
+wget https://freedombone.net/downloads/current/freedombone-pleroma-amd64.img.xz
+wget https://freedombone.net/downloads/current/freedombone-pleroma-amd64.img.xz.sig
+gpg --verify freedombone-pleroma-amd64.img.xz.sig
+unxz freedombone-pleroma-amd64.img.xz
+sudo dd if=/dev/zero of=/dev/sdX bs=1M count=8
+sudo dd bs=1M if=freedombone-pleroma-amd64.img of=/dev/sdX conv=fdatasync
+
+
+ +

+Also note that if the laptop has a removable SSD drive it's possible to copy the image directly to that if you have enough equipment. +

+
+
+ +
+

Connect the laptop to your internet router

+
+

+With the ethernet cable. +

+ +
+ +
+

laptop_router.jpg +

+
+
+
+
+ +
+

Boot the laptop from the USB drive

+
+

+You may need to alter the BIOS settings to get this to work reliably. +

+ +
+ +
+

bios_boot_usb.jpg +

+
+
+
+
+ +
+

Forward ports 80 (HTTP) and 443 (HTTPS) from your internet router to the laptop

+
+

+Log into your internet router using a non-Tor browser (usually it's on an address like 192.168.1.1 or 192.168.1.254). Often port forwarding settings are together with firewall settings. +

+ +
+ +
+

port_forwarding.png +

+
+
+
+
+ +
+

From another machine ssh into the laptop

+
+
+
ssh fbone@freedombone.local -p 2222
+
+
+ +

+Or alternatively you can log in directly on the laptop. The initial username is fbone and the password is freedombone. You should make sure you write down or copy the new password when it is shown. +

+
+
+ +
+

Follow the setup procedure

+
+

+Enter your user details, domain name and dynamic DNS settings. +

+
+
+ +
+

When installation is complete

+
+

+Navigate to your domain and register a new user. +

+ +
+ +
+

pleroma_register.jpg +

+
+
+
+