Snowflake is a [[PluggableTransports|pluggable transport]] that proxies traffic through temporary proxies using [WebRTC](https://webrtc.org/), a peer-to-peer protocol with built-in NAT punching. It aims to work kind of like flash proxy, but without flash proxy's problems with NAT.
\ No newline at end of file
Snowflake is a [[PluggableTransports|pluggable transport]] that proxies traffic through temporary proxies using [WebRTC](https://webrtc.org/), a peer-to-peer protocol with built-in NAT punching. It aims to work kind of like flash proxy, but without flash proxy's problems with NAT.
Firstly make sure you have WebRTC enabled. Then you can install [this addon](https://addons.mozilla.org/en-US/firefox/addon/torproject-snowflake/) for Firefox or [this one](https://chrome.google.com/webstore/detail/snowflake/mafpmfcccpbjnhfhjnllmmalhifmlcie) for Chrome which will let you become a Snowflake proxy. It can also inform you about how many people you have helped in the last 24 hours.
### Option 2 (web browser)
In a browser where WebRTC is enabled:
1. Go to https://snowflake.torproject.org/embed and toggle the button to opt in to being a proxy. You shouldn't close that page if you want to remain a snowflake bridge.
### Option 3 (standalone)
0. First you will need to install and configure Go to build the standalone proxy-go code. If you are running Ubuntu or Debian, you can install Go by executing `apt install golang`. Otherwise visit [[https://golang.org/dl/]]. Once it is installed, set up your workspace and environment variables (more detailed instructions here: [https://golang.org/doc/code.html#Workspaces]).
```
mkdir -p ~/go/src
echo "export GOPATH=$HOME/go" >> ~/.bash_profile
source ~/.bash_profile
}}}
1. Clone the [[#Source code]] the `src/` directory of your workspace.
2. Get the dependencies and build the source code.
{{{
cd snowflake
cd proxy
go get
go build
}}}
3. For our fallback proxy-go instances on snowflake-broker, [we manage proxy-go instances using runit](https://trac.torproject.org/projects/tor/wiki/org/teams/AntiCensorshipTeam/SnowflakeBridgeSurvivalGuide#Standaloneproxy-goinstances). However, a simpler nohup command will also allow you to run an instance in the background.
2018-11-30: Snowflake is included in [alpha releases of Tor Browser](https://www.torproject.org/download/alpha/) for GNU/Linux and macOS. Not Windows yet.
Further integration of Snowflake into Tor Browser is being tracked at ticket #19001.
To build from source code, see [[doc/TorBrowser/Hacking]]. In the tor-browser-build directory, `make alpha` or `make testbuild` will result in browsers with included Snowflake.
## WebRTC fingerprintability
Notes at [[Snowflake/Fingerprinting]].
## Reporting bugs
If you encounter problems with Snowflake as a client or a proxy, please [file a ticket](https://trac.torproject.org/projects/tor/newticket?component=Circumvention%2FSnowflake) using our bug tracker. To do so, you will have to [create an account](https://trac.torproject.org/projects/tor/register) or log in using the shared **cypherpunks** account with password **writecode**.
Please try to be as descriptive as possible with your ticket and if possible include log messages that will help us reproduce the bug. Consider adding keywords `snowflake-webextension` or `snowflake-client` to let us know how which part of the Snowflake system is experiencing problems.
