https://github.com/unredacted/ansible-role-snowflake

Ansible role to setup & run snowflake proxies and servers
https://github.com/unredacted/ansible-role-snowflake

Last synced: about 2 months ago
JSON representation

Ansible role to setup & run snowflake proxies and servers

• Host: GitHub
• URL: https://github.com/unredacted/ansible-role-snowflake
• Owner: unredacted
• License: gpl-3.0
• Created: 2023-06-23T06:46:04.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-06-28T05:46:50.000Z (over 1 year ago)
• Last Synced: 2024-01-03T09:04:51.849Z (about 1 year ago)
• Language: Jinja
• Size: 19.5 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
ansible-role-snowflake

=========

This Ansible role helps you run Snowflake, a censorship resistant pluggable transport to help people reach the Tor network.

Currently the role helps you run a Snowflake server, which is different than a Snowflake proxy https://gitlab.torproject.org/tpo/anti-censorship/pluggable-transports/snowflake/-/tree/main/server

At the moment, running a Snowflake server doesn't do anything as Snowflake clients won't use it. Described more in https://gitlab.torproject.org/tpo/anti-censorship/pluggable-transports/snowflake/-/issues/40248

If you want to run a Snowflake proxy with Ansible, please check out https://github.com/nvjacobo/snowflake

Requirements

------------

You need root privileges or sudo user to run this role.

Role Variables

--------------

Check `defaults/main.yml` for the full list of variables and their defaults.

Dependencies

------------

None.

Example Playbook

----------------

```

- name: Run the ansible-role-snowflake role and include custom vars

  remote_user: root

  hosts: '{{ target }}'

  vars_files:

    - vars/snowflake-servers.yml

  roles:

    - ansible-role-snowflake

  pre_tasks:

  - name: Remove the snowflake repo to grab it fresh

    ansible.builtin.shell: "rm -rf /home/snowflake"

```

License

-------

GPLv3

Author Information

------------------

Created by https://unredacted.org/

Credits

------------------

Some code was used from https://github.com/nvjacobo/snowflake