<commit_before>![SecureDrop](https://raw.github.com/freedomofpress/securedrop/master/docs/images/logo.png)

SecureDrop is an open-source whistleblower submission system managed by Freedom of the Press Foundation that media organizations use to securely accept documents from anonymous sources. It was originally coded by the late <NAME>.

# Technical Summary

SecureDrop is a tool for sources to communicate securely with journalists. The SecureDrop application environment consists of four dedicated computers:

* `Viewing Station`: An airgapped laptop running Tails from a USB stick that journalists use to decrypt and view submitted documents. (If this laptop does not have a DVD drive, buy an external DVD drive you can use with it.)
* `Source Server`: Ubuntu server running a Tor hidden service that sources use to send messages and documents to journalists.
* `Document Server`: Ubuntu server running a Tor hidden service that journalists use to download encrypted documents and respond to sources.
* `Monitor`: Ubuntu server that monitors the `Source` and `Document` servers and sends email alerts.

In addition to these computers, journalists use normal workstation computers:

* `Journalist Workstations`: The every-day laptops that journalists use. They will use this computer to connect to the `Document Server` to respond to sources and download encrypted documents to copy to the `Viewing Station`. They will also copy encrypted documents back from the `Viewing Station` station to this computer to do final work before publication.

These computers should all physically be in your organization's office. 

## Before You Begin

Before beginning installation, you should have three servers running Ubuntu Server 12.04.3 LTS, each with the grsec kernel patches installed. If you don't yet have those computers configured, see additional documentation for [Preparing Ubuntu servers for installation](https://github.com/freedomofpress/securedrop/blob/master/docs/ubuntuconfig.md).

You will need a DVD with the latest version of the [Tails](https://tails.boum.org/download/index.en.html) operating system burned to it. You will only have to use this DVD once: After the first run from a Live DVD you can create a Live USB to boot from instead. If you already have a Tails Live USB, you may skip this requirement.

You will also need a total of three USB sticks:
* USB stick with Tails for the `Viewing Station`
* USB stick for transfering files from the `Journalist Workstations` to the `Viewing Station`
* USB stick for transfering files from the `Viewing Station` to the `Journalist Workstations`

Finally, you will also need to come up with and memorize a series of passphrases. The best way to generate secure passphrases is to follow the [Diceware method](http://world.std.com/~reinhold/diceware.html). Generating secure passphrase takes time, so we recommend you generate these at the beginning of the installation process. You will need passphrases for:

* `Viewing Station`'s Tails Persistent Volume
* `Viewing Station`'s OpenPGP secret key
* `Viewing Station`'s SSL certificate authority secret key

Each journalist will also need to come up with a password for login to the `Document Server`.

After installing and configuring Ubuntu Server on `Source Server`, `Document Server`, and `Monitor Server`, and download, verifying, and burning Tails to a Live DVD, follow the [SecureDrop Installation Guide](https://github.com/freedomofpress/securedrop/blob/master/docs/install.md).

## License

SecureDrop is open source and released under the [GNU General Public License v2](https://github.com/freedomofpress/securedrop/blob/master/LICENSE). 

The [wordlist](https://github.com/freedomofpress/securedrop/blob/master/modules/deaddrop/files/deaddrop/wordlist) we use to generate source passphrases comes from [Diceware](http://world.std.com/~reinhold/diceware.html), and is licensed under Creative Commons Attribution 3.0 Unported thanks to <NAME>. <commit_msg>add SMTP server requirement to readme<commit_after>![SecureDrop](https://raw.github.com/freedomofpress/securedrop/master/docs/images/logo.png)

SecureDrop is an open-source whistleblower submission system managed by Freedom of the Press Foundation that media organizations use to securely accept documents from anonymous sources. It was originally coded by the late <NAME>.

# Technical Summary

SecureDrop is a tool for sources to communicate securely with journalists. The SecureDrop application environment consists of four dedicated computers:

* `Viewing Station`: An airgapped laptop running Tails from a USB stick that journalists use to decrypt and view submitted documents. (If this laptop does not have a DVD drive, buy an external DVD drive you can use with it.)
* `Source Server`: Ubuntu server running a Tor hidden service that sources use to send messages and documents to journalists.
* `Document Server`: Ubuntu server running a Tor hidden service that journalists use to download encrypted documents and respond to sources.
* `Monitor`: Ubuntu server that monitors the `Source` and `Document` servers and sends email alerts.

In addition to these computers, journalists use normal workstation computers:

* `Journalist Workstations`: The every-day laptops that journalists use. They will use this computer to connect to the `Document Server` to respond to sources and download encrypted documents to copy to the `Viewing Station`. They will also copy encrypted documents back from the `Viewing Station` station to this computer to do final work before publication.

These computers should all physically be in your organization's office. 

## Before You Begin

Before beginning installation, you should have three servers running Ubuntu Server 12.04.3 LTS, each with the grsec kernel patches installed. If you don't yet have those computers configured, see additional documentation for [Preparing Ubuntu servers for installation](https://github.com/freedomofpress/securedrop/blob/master/docs/ubuntuconfig.md).

You will need a DVD with the latest version of the [Tails](https://tails.boum.org/download/index.en.html) operating system burned to it. You will only have to use this DVD once: After the first run from a Live DVD you can create a Live USB to boot from instead. If you already have a Tails Live USB, you may skip this requirement.

You will also need a total of three USB sticks:
* USB stick with Tails for the `Viewing Station`
* USB stick for transfering files from the `Journalist Workstations` to the `Viewing Station`
* USB stick for transfering files from the `Viewing Station` to the `Journalist Workstations`

The `Monitor Server` also sends emails. You will need an SMTP server, such as your company's mail server.

Finally, you will also need to come up with and memorize a series of passphrases. The best way to generate secure passphrases is to follow the [Diceware method](http://world.std.com/~reinhold/diceware.html). Generating secure passphrase takes time, so we recommend you generate these at the beginning of the installation process. You will need passphrases for:

* `Viewing Station`'s Tails Persistent Volume
* `Viewing Station`'s OpenPGP secret key

Each journalist will also need to come up with a password for login to the `Document Server`.

After installing and configuring Ubuntu Server on `Source Server`, `Document Server`, and `Monitor Server`, and download, verifying, and burning Tails to a Live DVD, follow the [SecureDrop Installation Guide](https://github.com/freedomofpress/securedrop/blob/master/docs/install.md).

## License

SecureDrop is open source and released under the [GNU General Public License v2](https://github.com/freedomofpress/securedrop/blob/master/LICENSE). 

The [wordlist](https://github.com/freedomofpress/securedrop/blob/master/modules/deaddrop/files/deaddrop/wordlist) we use to generate source passphrases comes from [Diceware](http://world.std.com/~reinhold/diceware.html), and is licensed under Creative Commons Attribution 3.0 Unported thanks to <NAME>. 
{'fraction_non_alphanumeric': 0.06106679960119641, 'fraction_numerical': 0.0019940179461615153, 'mean_word_length': 5.0841546626232, 'pattern_counts': {'":': 0, '<': 7, '<?xml version=': 0, '>': 7, 'https://': 12, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 8, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '390093', 'n_tokens_mistral': 2043, 'n_tokens_neox': 1917, 'n_words': 1044}