freedomboneeee/doc/EN/socialinstance.org

3.0 KiB

/free/freedomboneeee/src/commit/d6d4e61d6f48ac94304ae357763a0294f0953a1b/doc/EN/images/logo.png

Social Instance

A social instance image allows you to easily set up a fediverse server, which federates using the OStatus or ActivityPub protocol. You will need:

  • An old laptop, capable of booting from USB
  • A USB drive, preferably Sandisk and 16GB or larger
  • An ethernet patch cable
  • A domain name of your own
  • A dynamic DNS account

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

Substitute sdX with the device name for your USB drive.

sudo apt-get install xz-utils wget
wget https://freedombone.net/downloads/v31/freedombone-pleroma-amd64.img.xz
wget https://freedombone.net/downloads/v31/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=32M count=8
sudo dd bs=32M if=freedombone-pleroma-amd64.img of=/dev/sdX conv=fdatasync,sync,noerror

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

Plug the USB drive into the laptop and connect it to your internet router with the ethernet cable.

/free/freedomboneeee/src/commit/d6d4e61d6f48ac94304ae357763a0294f0953a1b/doc/EN/images/laptop_router.jpg

Boot the laptop from the USB drive

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

/free/freedomboneeee/src/commit/d6d4e61d6f48ac94304ae357763a0294f0953a1b/doc/EN/images/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.

/free/freedomboneeee/src/commit/d6d4e61d6f48ac94304ae357763a0294f0953a1b/doc/EN/images/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.

/free/freedomboneeee/src/commit/d6d4e61d6f48ac94304ae357763a0294f0953a1b/doc/EN/images/pleroma_register.jpg

More details about setting up and using Pleroma can be found here.

/free/freedomboneeee/src/commit/d6d4e61d6f48ac94304ae357763a0294f0953a1b/doc/EN/images/tusky.jpg