Преглед на файлове

Improve setup description

Bob Mottram преди 8 години
родител
ревизия
c1d098d3a3
променени са 1 файла, в които са добавени 18 реда и са изтрити 6 реда
  1. 18
    6
      doc/EN/homeserver.org

+ 18
- 6
doc/EN/homeserver.org Целия файл

@@ -87,7 +87,6 @@ password: freedombone
87 87
 If you're installing from a microSD card on a single board computer without a screen and keyboard attached then you can ssh into it with:
88 88
 
89 89
 #+begin_src bash
90
-freedombone-client
91 90
 ssh fbone@freedombone.local -p 2222
92 91
 #+end_src
93 92
 
@@ -95,27 +94,40 @@ Using the initial password "/freedombone/".
95 94
 
96 95
 You will then be shown a new randomly generated password. It's *very important* that you write this down somewhere before going further, because you'll need this to log in later.
97 96
 
98
-You'll be asked to set a username and a "real" name (or nickname), then the rest of the installation will be automatic. Again, it takes a while, so go and do something less boring instead.
97
+You'll be asked to set a username and a "real" name (or nickname), then the rest of the installation will be automatic. Again, it takes a while, so go and do something less boring instead. At the end of the base install you can also choose to install specific apps, but if you want to do that later then just press Enter.
98
+
99
+When it's installed on your local system open a terminal and verify the ssh server key hash with:
100
+
101
+#+begin_src bash
102
+freedombone-client --verify
103
+#+end_src
99 104
 
100
-When it's installed on your local system open a terminal and run:
105
+This will show the hash code for the public ssh key of the Freedombone system. Open another terminal window then run:
101 106
 
102 107
 #+begin_src bash
108
+freedombone-client
103 109
 ssh myusername@freedombone.local -p 2222
104 110
 #+end_src
105 111
 
106
-Use the password you wrote down earlier to log in.
112
+Use the password you wrote down earlier to log in. Select the *administrator control panel* with up and down cursor keys, space bar and enter key. You should see something like this, and you might need to re-enter your password.
107 113
 
108 114
 #+BEGIN_CENTER
109 115
 [[file:images/controlpanel/control_panel.jpg]]
110 116
 #+END_CENTER
111 117
 
112
-Select the *administrator control panel* with up and down cursor keys, space bar and enter key. You might need to re-enter your password. Then select *About*. You'll see a list of sites and their onion addresses.
118
+Then select *About*. You'll see a list of sites and their onion addresses.
113 119
 
114 120
 #+BEGIN_CENTER
115 121
 [[file:images/controlpanel/control_panel_about.jpg]]
116 122
 #+END_CENTER
117 123
 
118
-On your local system open a *Tor compatible browser* and enter your blog's onion address. If it's all working then you should see your new blog.
124
+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.
125
+
126
+You have now confirmed a secure connection. Probably. If you're still sceptical then you can power off the system, remove the microSD card and manually check the public keys within the /etc/ssh directory on the drive.
127
+
128
+Press any key to exit from the About screen. You can then select *Add/Remove apps* and add whatever applications you wish to run. Note that some apps will only run on x86 systems, but most will install and run on ARM single board computers.
129
+
130
+Once your apps have installed you can go back to the About screen, pick an onion address and try it within a Tor compatible browser.
119 131
 
120 132
 *Congratulations! You have now become a citizen of the free internet.*
121 133