aboutsummaryrefslogtreecommitdiffstats
path: root/freedom-maker/README
blob: 1428d26438d634843803460a416d5ba354298a5f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
Freedom-Maker  -  Bdale's building tools for the FreedomBox project

Install required build packages:
	apt-get install multistrap qemu-user-static

To build for a DreamPlug, use

	sudo ./mk_dreamplug_rootfs

This will yield a file tree under build/dreamplug, representing the
contents of a root file system.  Get that onto a USB stick with a Linux
friendly file system (ext3 and not vfat) with something like

	sudo mount /dev/sdc1 /media/freedom
	sudo rsync -atvz --progress build/dreamplug/ /media/freedom/
	sudo umount /media/freedom

Move the USB stick to the DreamPlug, and arrange to boot the existing kernel
from internal microSD pointing to our new root filesystem by interrupting the
boot to talk to U-Boot:

	screen /dev/ttyUSB0 115200
# Reboot the DreamPlug
# You should see "Hit any key to stop autoboot:  " - hit a key, any key
	setenv x_bootargs_root root=/dev/sdc1 rootdelay=10
	saveenv
	reset

The system should boot to a login prompt and the default password is
'freedom' for the root user.

- - - - -

If you want to set things up to boot from the internal microSD card, once
you're logged into the system booted from root on USB stick you can use:

	sh /boot/copy2dream.sh

If you choose to to reflash the device entirely you'll want to do the
following to switch the root filesystem back to the internal microSD card:

	screen /dev/ttyUSB0 115200
# Reboot the DreamPlug
# You should see "Hit any key to stop autoboot:  " - hit a key, any key
	setenv x_bootargs_root root=/dev/sda2 rootdelay=10
	saveenv
	reset

- - - - -

To turn the device into a Torouter you'll want to do the following:
	# ssh or login to the router
	wget https://gitweb.torproject.org/torouter.git/blob_plain/HEAD:/packages/torouter_easy_setup.sh
	bash torouter_easy_setup.sh
	reboot

This should result in a proper Torouter without any need for further configuration.

Be aware that this is an imcomplete solution for now .. you will want to at
least do things like create unique ssh host keys for your device!