Skip to content

Commit

Permalink
directory-structure (#24): directory-structure/ (folder) created to s…
Browse files Browse the repository at this point in the history
…erve as example of what docs/ talk about
  • Loading branch information
fititnt committed Nov 9, 2020
1 parent 74247f5 commit f0d20e6
Show file tree
Hide file tree
Showing 15 changed files with 50 additions and 11 deletions.
30 changes: 21 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ cp -r /tmp/bootstrap-tails/bin /home/amnesia/bin
/home/amnesia/bin/tails-do-it
```

> [[issue#34](https://github.com/fititnt/TailsOS-for-non-whistleblowers/issues/34)] The initial target audience of this project
> [[issue#34](https://github.com/fititnt/AdHocSecurebox/issues/34)] The initial target audience of this project
>
> TODO: add description of the initial reasons for this project. But definitely mention about Domestic Violence survivors (fititnt, 2020-11-07 21:11 BRT)
Expand All @@ -24,8 +24,9 @@ cp -r /tmp/bootstrap-tails/bin /home/amnesia/bin
2. [Tails](#tails)
1. [Overview](#overview)
1. [`bin/`: Tails executable scripts](#bin-tails-executable-scripts)
2. [`docs/`: Tails guides by topic](#docs-tails-guides-by-topic)
3. [`dotfiles/example/`](#dotfilesexample)
2. [`directory-structure/`: Example of directory structure](#directory-structure-example-of-directory-structure)
3. [`docs/`: Tails guides by topic](#docs-tails-guides-by-topic)
4. [`dotfiles/example/`](#dotfilesexample)
2. [Installation](#installation)
1. [Simple](#simple)
2. [Via git](#via-git)
Expand Down Expand Up @@ -82,6 +83,16 @@ Look at the folder [bin/](bin/) for inspirational scripts to add to your
`/home/amnesia/bin`<sup>Amnesic</sup> /
`/live/persistence/TailsData_unlocked/dotfiles/bin`<sup>Persistent</sup>.

#### `directory-structure/`: Example of directory structure

- [directory-structure/](directory-structure/)

If you don't plan to read the documentation at [docs/](docs/) and is just browsing
this repository, this is the folder you look around to see potential examples.

These folders are not used for copy or automation (like [bin/](bin/) is). This is
just an documental syntactic sugar.

#### `docs/`: Tails guides by topic

Look at the folder [docs/](docs/) for POSIX scripts and markdown files mean to be read.
Expand All @@ -92,15 +103,16 @@ Look at the folder [docs/](docs/) for POSIX scripts and markdown files mean to b

The folder [dotfiles/example/](dotfiles/example/) contain examples of dotfiles.

Some, like the [dotfiles/example/rocha/.curlrc](dotfiles/example/rocha/.curlrc) that help with curl
be able to proxy via Tor, may be pertinent to reduce extra parameters.
Some, like the [dotfiles/example/rocha/.curlrc](dotfiles/example/rocha/.curlrc)
that help with curl be able to proxy via Tor, may be pertinent to reduce extra
parameters.

### Installation

#### Simple

```bash
git clone https://github.com/fititnt/TailsOS-for-non-whistleblowers.git /tmp/bootstrap-tails
git clone https://github.com/fititnt/AdHocSecurebox.git /tmp/bootstrap-tails
# mv /home/amnesia/bin /home/amnesia/bin.bkp
cp -r /tmp/bootstrap-tails/bin /home/amnesia/bin
/home/amnesia/bin/tails-do-it
Expand All @@ -114,8 +126,8 @@ have his /home/amnesia/.ssh/id_rsa autorized to connect GitHub.
```bash
# From an already running TailsOS with persistence enabled, run:
mkdir /home/amnesia/Persistent/git ; mkdir /home/amnesia/Persistent/git/fititnt/ ; cd /home/amnesia/Persistent/git/fititnt
git clone https://github.com/fititnt/TailsOS-for-non-whistleblowers.git
cd /home/amnesia/Persistent/git/fititnt/TailsOS-for-non-whistleblowers
git clone https://github.com/fititnt/AdHocSecurebox.git
cd /home/amnesia/Persistent/git/fititnt/AdHocSecurebox
```

### Acknowledgements
Expand Down Expand Up @@ -153,7 +165,7 @@ See [docs/beyond-tails/workspace/](docs/beyond-tails/workspace/).

### YubiKey

This is an draft. See [YubiKey on Tails #28](https://github.com/fititnt/TailsOS-for-non-whistleblowers/issues/28).
This is an draft. See [YubiKey on Tails #28](https://github.com/fititnt/AdHocSecurebox/issues/28).

## Reuse of this work

Expand Down
2 changes: 1 addition & 1 deletion apparmor-profiles/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# TailsOS-for-non-whistleblowers/apparmor-profiles
# AdHocSecurebox/apparmor-profiles

This folder contain examples of AppArmor profiles.

Expand Down
19 changes: 19 additions & 0 deletions directory-structure/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# AdHocSecurebox/directory-structure

> TODO: add some description (fititnt, 2020-11-08 23:23 BRT)
- [generic-linux/](generic-linux): Suggestion of directory structure
to use on an Non-Tails Linux distributions.
- `/workspace` (workspace at root /) is open to discussion (and
maybe worth make it configurable) but the folders inside
still a good idea to keep.
- [tails-with-persistence/](tails-with-persistence/): directory structure
if you boot up Tails and unlock Persiscence.
- `/live/persistence/TailsData_unlocked/Persistent` and
`/home/amnesia/Persistent/` are paths to same content.
- [tails-without-persistence/](tails-without-persistence): directory structure
if you start from Tails live USB without persistence and plan to create
the paths manually.
- Tip: the quickstart `AdHocSecurebox` example assumes this directory
structure, but the scripts are made in such way that they could work
if you have persistence enabled too.
File renamed without changes.
Empty file.
Empty file.
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
/workspace/ramfs NOT ready to use. Please configure before save files here.
Empty file.
Empty file.
9 changes: 8 additions & 1 deletion docs/portable-data.sh
Original file line number Diff line number Diff line change
Expand Up @@ -14,15 +14,22 @@
# AUTHOR: Emerson Rocha <rocha[at]ieee.org>
# COMPANY: Etica.AI
# LICENSE: Public Domain
# VERSION: 0.1 (draft)
# VERSION: 0.2 (draft)
# CREATED: 2020-10-25 23:28 UTC v0.1 (draft)
# 2020-11-08 23:14 UTC v0.2 Added draft of example directories
# as empty folders on the git repository at
# directory-structure/
#===============================================================================
echo "Usage:"
echo " cat portable-software.sh"
echo " cat portable-data.sh"
echo "exiting..."
exit 0

## TODO: move the description of "portable data" to (maybe) simply create example
# directories on AdHocSecurebox/directory-structure with descritive
# comments (2020-11-08 23:14)

##### 1. Requisites ____________________________________________________________
#### 1.1 Read Tails official documentation about setup persistence .............
xdg-open https://tails.boum.org/doc/first_steps/persistence/index.en.html
Expand Down

0 comments on commit f0d20e6

Please sign in to comment.