Selaa lähdekoodia

Improve setup description

Bob Mottram 8 vuotta sitten
vanhempi
commit
c1d098d3a3
1 muutettua tiedostoa jossa 18 lisäystä ja 6 poistoa
  1. 18
    6
      doc/EN/homeserver.org

+ 18
- 6
doc/EN/homeserver.org Näytä tiedosto

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:
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
 #+begin_src bash
89
 #+begin_src bash
90
-freedombone-client
91
 ssh fbone@freedombone.local -p 2222
90
 ssh fbone@freedombone.local -p 2222
92
 #+end_src
91
 #+end_src
93
 
92
 
95
 
94
 
96
 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.
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
 #+begin_src bash
107
 #+begin_src bash
108
+freedombone-client
103
 ssh myusername@freedombone.local -p 2222
109
 ssh myusername@freedombone.local -p 2222
104
 #+end_src
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
 #+BEGIN_CENTER
114
 #+BEGIN_CENTER
109
 [[file:images/controlpanel/control_panel.jpg]]
115
 [[file:images/controlpanel/control_panel.jpg]]
110
 #+END_CENTER
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
 #+BEGIN_CENTER
120
 #+BEGIN_CENTER
115
 [[file:images/controlpanel/control_panel_about.jpg]]
121
 [[file:images/controlpanel/control_panel_about.jpg]]
116
 #+END_CENTER
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
 *Congratulations! You have now become a citizen of the free internet.*
132
 *Congratulations! You have now become a citizen of the free internet.*
121
 
133