summaryrefslogtreecommitdiffstats
path: root/wiki/src/blueprint/bootstrapping.mdwn
blob: f77e7e38c57e19a002e97880d20d0a6b10af878b (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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
[[!meta title="Bootstrapping workflow"]]

This blueprint analyses and proposes simplifications to the workflow of
a new user discovering Tails until she gets a full-featured Tails USB
stick with persistence.

Big logical steps are:

  - Learn what Tails is
  - Download the ISO
  - Verify the ISO
  - Install medium (might require going through a bootstrapping medium)
  - Create persistence

Subpages
========

[[!map pages="page(blueprint/bootstrapping/*)"]]

Table of content
================

[[!toc levels=3]]

2014
====

[[Diagram of the detailed workflow as of December 2014|2014.fodg]]

2015
====

Over 2015 we will work on several improvements to simplify greatly this
workflow:

  - Tails Installer in Debian
  - [[Browser extensions|download_extension]] for automatic verification of the ISO
  - [[Web assistant|web_assistant]] to guide the user throughout this process

[[Diagram of the detailed workflow as of December 2015|2015.fodg]] (work in progress)

<a id="tools"></a>

Involved tools
--------------

[[!img tools.png link=tools.fodg]]

Notes:

- **Debian Hacker** corresponds to a path on the command line only. This
  main benefit is to go through the **Debian keyring** verification.
- **Debian** is a path for Debian derivatives where Tails Installer is
  available. That should be the case of Ubuntu starting from 15.10, and
  Debian Stretch unless we backport it for Jessie ([[!tails_ticket 8805]]).
- **Other OS** is Windows, Mac OS X, Fedora, etc.
- **Debian keyring** are command line instructions for verifying the
  Tails signing key against the Debian keyring.
- **Extension from Debian** takes for granted that the ISO verification
  extension will be available in Debian ([[!tails_ticket 8822]]. That
  might not be the case and then people would fallback on "Extension
  from browser".
- **GNOME Disks** now has a "Restore Disk Image" feature which should do the
  trick and is widely available, see [[!tails_ticket 8664]].
- **UUI** has been our canonical installer for years, but we should also test
  **Rufus**, see [[!tails_ticket 7034]].
- **DiskUtils** should be tested on Mac, see [[!tails_ticket 8802]].

Use cases
=========

This is a brainstorming on the different use cases dealing with
downloading, verifying, installing, and upgrading Tails.
This list should be useful to check whether all scenarios are covered.
The comments, placed after ':' correspond to our rough objectives for
2015.

- Download
  - HTTP
    - Successful: 15 to 60 minutes
    - Failed: ?
    - Corrupted: ?
  - Torrent
    - Corrupted: ?
  - Nightly
- Verify
  - Checksum
    - Firefox: extension, what's up with Torrents?
    - Chrome: extension? [[!tails_ticket 8803]], [[!tails_ticket 8531]]
    - Other browsers:
      - Windows: fallback on OpenPGP?
      - Mac: fallback on OpenPGP?
      - Linux: fallback on OpenPGP?
  - OpenPGP
    - GNOME: seahorse-nautilus
    - Other Linux: command line
    - Windows: Gpg4Win
    - Mac: GPGTools [[!tails_ticket 8807]]
- Install
  - DVD
  - USB
    - Tails: friend + Tails Installer
    - Debian
      - Jessie: Tails Installer backport? [[!tails_ticket 8005]]
      - Stretch: Tails Installer [[!tails_ticket 8549]]
    - Ubuntu
      - Latest LTS, 14.04: Tails Installer? [[!tails_ticket 8806]]
      - Latest, 15.04: Tails Installer? [[!tails_ticket 8806]]
      - Next LTS, 16.04: Tails Installer? [[!tails_ticket 8806]]
      - Next, 15.10: Tails Installer? [[!tails_ticket 8806]]
  - Windows: UUI
  - Mac OS X: command line or new graphical tool? [[!tails_ticket 8802]]
  - Virtualization: VirtualBox, GNOME Boxes, virt-manager
- Upgrade from ISO (full upgrade or nightly)
  - Full upgrade
    - From Debian, Ubuntu if available
    - From Tails otherwise: need bootstrapping device
  - Incremental upgrade
  - Virtualization: virt-manager
- Misc
  - Newsletter
  - Donation: [[!tails_ticket 7176]]?
  - Backups: [[!tails_ticket 8812]]?
  - Signing key revocation or change