Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions docs/Connections/dropbox.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,8 @@ Similarly to other server connections (like [Tella Web](/tella-web), [Google Dri
Submissions to Dropbox take the form of "reports" which include a title, a text description, and files like photos, videos and audio recordings.

:::danger
Even though data is transferred to the server securely (SSL), anyone with access to the Dropbox account can view the files. If you need encrypted file transfers, explore [Nearby Sharing](/nearby-sharing).
Even though data is encrypted (SSL) when transferred to your Dropbox account, anyone with access to the Dropbox account can view the files.
:::

:::note
The Dropbox connection is not available in Tella Android FOSS, because it uses closed-sourced libraries.
Expand Down Expand Up @@ -121,7 +122,7 @@ The Outbox contains:
* Reports that were marked as "Submit later"

:::tip
If you need a fully offline way to share files with others, consider exploring [Nearby Sharing](/nearby-sharing).
If you need a way of sharing files without an internet connection, consider exploring [Nearby Sharing](/nearby-sharing).
:::


Expand Down
12 changes: 6 additions & 6 deletions docs/Connections/for-organizations.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Currently, Tella can be connected to the following types of servers:
These are called [Connections](/features#connecting-to-servers) in Tella.

:::danger
For now, any files you submit to a connection might stored unencrypted on that server or drive (that depends on the server configuration). This means that anyone with permission to access the content of that server or drive may be able to view those files. While the connection used to submit files is secured via HTTPS, the files themselves must be decrypted to be accessed outside of the Tella vault.
For now, any files you submit to a connection may be stored unencrypted on that server or drive--this depends on the configuration of the server or drive, unrelated from Tella. This means that anyone with permission to access the content of that server or drive may be able to view those files. While the connection used to submit files is secured via HTTPS, the files themselves must be decrypted to be accessed outside of the Tella vault.

We strongly recommend reviewing and understanding the permission model of each connection you use, in order to determine which option is safest and most appropriate for your specific use case.
:::
Expand Down Expand Up @@ -59,7 +59,11 @@ On this table we explain what server types are available on the Tella apps:
<ConnectionsTable/>

:::info
For offline file sharing or during internet shutdowns, [Nearby Sharing](/nearby-sharing) could be helpful. If you need to share files with other apps the [Share button](/features#share-button) could be useful.
For offline file sharing or during internet shutdowns, check out [Nearby Sharing](/nearby-sharing) could be helpful.
:::

:::info
To share files through other apps, use the [Share button](/features#share-button).
:::

### Tella Web {#tella-web}
Expand Down Expand Up @@ -108,10 +112,6 @@ As for all Connections in Tella, users can use most of the Google Drive connecti

<Button label="Continue reading about the Google Drive connection " link="/g-drive"/>

Users can sign-in directly to their Google account from within Tella and upload files to a folder in their Drive account. Each "report" uploaded will create a new folder in the user's Google Drive.

As for all Connections in Tella, users can use most of the Google Drive connection offline through the Draft, Outbox and Submit Later tabs.

:::note
The Google Drive connection is not available in Tella Android FOSS, because it uses closed-sourced libraries.
:::
Expand Down
2 changes: 1 addition & 1 deletion docs/Connections/g-drive.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ The Google Drive connection is not available in Tella Android FOSS, because it u
:::

:::danger
Even though data is transferred to the server securely (SSL), anyone with access to the Google Drive account can view the files. If you need encrypted file transfers, explore [Nearby Sharing](/nearby-sharing).
Even though data is encrypted (SSL) when transferred to your Dropbox account, anyone with access to the Google Drive account can view the files.
:::

## When to Use Google Drive {#when-to-use-google-drive}
Expand Down
12 changes: 6 additions & 6 deletions docs/Connections/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,21 +18,21 @@ In addition to keeping their data protected within the app, users can use **Conn
- Volunteers or activists on the ground submitting forms directly to their organization from Tella.
- A group of people connecting to a drive, cloud, or shared space to send files.
- A group of journalists sharing encrypted data with each other during an internet shutdown.
- An individual backing up selected files to their personal computer.
- An individual backing up selected files to their personal computer or cloud file storage.


There are two main types of connections:
- [**Nearby Sharing**](#nearby-sharing): Share encrypted files with another Tella device in physical proximity. This feature does **not** require an internet connection and is typically used during internet shutdowns.
- [**Upload to a server**](#server-connections): Connect to a server and upload files over the internet so that others can access them. This feature is commonly used by organizations running data collection processes.
- [**Nearby Sharing**](#nearby-sharing): Securely share files with another Tella device in physical proximity. This feature does **not** require an internet connection and is typically used during internet shutdowns or in areas with limited connectivity.
- [**Upload to a server or drive**](#server-connections): Connect to a server or drive and upload files over the internet to back them or so that others can access them. This feature is commonly used by organizations that want to centralize data or files collected by Tella users, or by individuals looking to make up their files.

Connections can be configured on **Settings** → **Connections**. The Tella home screen will display a shortcut to all connected servers. Nearby Sharing is turned on by default, but it can be disabled as well.
Connections can be configured inside Tella in **Settings** → **Connections**. The Tella homescreen will display a shortcut to all connections. Nearby Sharing is turned on by default, but it can be disabled as well.


## Nearby Sharing {#nearby-sharing}

Nearby Sharing can be used to transfer files directly between Tella vaults. It is available on Tella Android, Tella iOS, and Tella Desktop. Transfers are encrypted, use the Wi-Fi protocol, and work with or without an internet connection, even on insecure or monitored networks.
Nearby Sharing can be used to transfer files directly from Tella on one device to Tella on another device. It is available on Tella Android, Tella iOS, and Tella Desktop. Transfers are encrypted and are done over Wi-Fi protocol. Nearby Sharing works with or without an internet connection, even on insecure or monitored networks.

We designed this connection type with a strong focus on security, especially for use in repressive environments, and it has been [audited by an independent security firm](/security-and-privacy#security-audits).
We designed this connection with a strong focus on security, especially for use in repressive environments, and it has been [audited by an independent security firm](/security-and-privacy#security-audits).

<Button label="Continue reading about Nearby Sharing" link="/nearby-sharing"/>

Expand Down
28 changes: 14 additions & 14 deletions docs/Connections/nearby-sharing.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,21 @@
---
id: nearby-sharing
title: Nearby Sharing
description: Learn about Tella's encrypted, cross-platform, fully offline feature for sharing files between Tella vaults in physical proximity. Available for Android, iOS and Desktop.
description: Learn about Tella's secure, cross-platform offline file-sharing features on Android, iOS and Desktop.
slug: /nearby-sharing
---

# Nearby Sharing

Nearby Sharing lets users securely share files, fully offline, across platforms and devices, assuring end-to-end encryption.
Nearby Sharing lets users securely share files between devices, offline and end-to-end encrypted.

This feature is designed centering the needs of people living in internet shutdowns, where privacy, security and reliability are crucial to keep connected. It's also helpful in rural areas, or for protests or large events where mobile networks are saturated or unavailable.
This feature was designed primarily to support users facing internet shutdowns or unreliable connectivity. It's also helpful in situations where mobile networks are saturated or unavailable.

Nearby Sharing in Tella is:
- *Independent of internet*: Transfers work with or without an internet connection, even on surveilled or insecure Wi-Fi networks, by establishing a direct connection between devices instead of routing through the internet.
- *Cross platform*: Available on iOS, Android and Desktop (Computer): there isn't any restrictions on which model of phone, brand or operative system you use. Nearby Sharing is designed to be accessible to any device able to install Tella.
- *Encrypted*: Files move directly from one Tella vault to another, encrypted and secure.
- *Anonymous*: Connection happens locally, without trace of who you shared with, when or where.
- *Independent of the internet*: Transfers work with or without an internet connection, included on monitored or insecure Wi-Fi networks, by establishing a direct connection between devices instead of routing through the internet.
- *Cross platform*: Nearby Sharing is available on iOS, Android, MacOS, Windows, and Linux, regardless of the device brand or model. Nearby Sharing can be used on any device where Tella can be installed.
- *Encrypted*: Files are transferred encrypted directly from one Tella vault to another.
- *Anonymous*: The connection between devices happens locally, without leaving traces of who you shared files with, when or where.


Nearby Sharing will only work in physical proximity, for users connected to the same Wi-Fi network (either a local Wi-Fi or a Hotspot).
Expand All @@ -25,10 +25,10 @@ Nearby Sharing will only work in physical proximity, for users connected to the

Nearby Sharing may be particularly well-suited for:
- Sharing files during an internet shutdown.
- High risk scenarios where internet is censored and cannot be trusted as a communication channel
- During protests, to quickly back up evidence on another person's phone.
- To increase redundancy of data, by backing up files to a personal computer or another device.
- To migrate to a new phone.
- High risk scenarios where internet is heavily monitored or censored, and cannot be trusted as a communication channel
- During protests or incidents, to quickly back up evidence on another person's phone.
- To increase redundancy of data by backing up files to a personal computer or another device.
- To migrate files to a new phone.


:::tip
Expand All @@ -49,11 +49,11 @@ If you are trying to share files to the organization you are working with, or if

Tap the Nearby Sharing button under the **Connections** section on the Tella Homescreen to get started.

In order to use the feature, the sender and receiver need to join the same Wi-Fi network. You can connect to mobile devices using Tella (Android or iOS) or connect a mobile device to a computer. There are 2 ways to connect your devices though Wi-Fi:
In order to use the feature, the sender and receiver need to be on the same Wi-Fi network. You can share files between two mobile devices (Android or iOS) or from a mobile device to a computer. There are 2 ways to connect your devices though Wi-Fi:
1. Using a local network, such as the Wi-Fi at your home or work, or a public Wi-Fi network.
2. Setting up a Hotspot on a device, and make sure both the sender and receiver have joined it. One of the devices can act as Hotspot and the other one could connect to it.
2. Setting up a Hotspot on a device, and making sure both the sender and receiver have joined it. One of the devices can act as Hotspot while the other one connects to it.

Nearby Sharing will show a tutorial that will guide users in every step of the connection process.
Nearby Sharing will show a tutorial to guide users in every step of the connection process.

:::note
Some public Wi-Fi networks might not work due to their configuration preventing direct transfers.
Expand Down
4 changes: 2 additions & 2 deletions docs/Connections/nextcloud.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Similarly to other server connections (like [Tella Web](/tella-web), [Google Dri
Submissions to Nextcloud take the form of "reports" which include a title, a text description, and files like photos, videos and audio recordings.

:::danger
Even though data is transferred to the server securely (SSL), anyone with access to the Nexctloud account can view the files. If you need encrypted file transfers, explore [Nearby Sharing](/nearby-sharing).
Even though data is encrypted (SSL) when transferred to your Nextcloud account, anyone with access to the Nextcloud account or server can view the files.
:::

## When to Use Nextcloud {#when-to-use-Nextcloud}
Expand Down Expand Up @@ -124,7 +124,7 @@ The Outbox contains:
* Reports that were marked as "Submit later"

:::tip
If you need a fully offline way to share files with others, consider exploring [Nearby Sharing](/nearby-sharing).
If you need to share files with others without an internet connection, check out [Nearby Sharing](/nearby-sharing).
:::


Expand Down
6 changes: 3 additions & 3 deletions docs/Connections/odk.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Similarly to any other server connection (like [Tella Web](/tella-web), [Google
4. Ensuring that organizations can preserve important information even in the event of device seizure or destruction, and can organize it for research, advocacy, or accountability processes.

:::danger
Even though data is transferred to the server securely (SSL), anyone with access to the ODK account can view the files. If you need encrypted file transfers, explore [Nearby Sharing](/nearby-sharing).
Even though data is encrypted (SSL) when transferred to the ODK account, anyone with access to the ODK account or server can view the data or files.
:::


Expand Down Expand Up @@ -140,5 +140,5 @@ Below is an overview of the ODK features that are supported in Tella Android. If


:::tip
If you need a fully offline way to share files with others, consider exploring [Nearby Sharing](/nearby-sharing).
:::
If you need to share files with others without an internet connection, check out [Nearby Sharing](/nearby-sharing).
:::
4 changes: 2 additions & 2 deletions docs/Connections/tella-web.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Setting up Tella Web involves three steps, which are thoroughly discussed in thi
* **Get people on the ground ready to start submitting reports**: Users install Tella on their Android or iPhone device. They then connect to the Tella Web project and start collecting information.

:::danger
Even though data is transferred to the server securely (SSL), anyone with access to the Tella Web account can view the files. If you need encrypted file transfers, explore [Nearby Sharing](/nearby-sharing).
Even though data is encrypted (SSL) when transferred to Tella Web, anyone with access to your Tella Web account or to the server can view the files.
:::

## When to Use Tella Web {#when-to-use-tella-web}
Expand Down Expand Up @@ -348,7 +348,7 @@ The Outbox contains:
* Reports that were marked as "Submit later"

:::tip
If you need a fully offline way to share files with others, consider exploring [Nearby Sharing](/nearby-sharing).
If you need to share files with others without an internet connection, check out [Nearby Sharing](/nearby-sharing).
:::


Expand Down
4 changes: 2 additions & 2 deletions docs/Connections/uwazi.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Similarly to all other server connections([Tella Web](/tella-web), [Google Drive
4. Ensuring that organizations can preserve important information even in the event of device seizure or destruction, and can organize it to use for research, advocacy, or accountability processes.

:::danger
Even though data is transferred to the server securely (SSL), anyone with access to the Uwazi account can view the files. If you need encrypted file transfers, explore [Nearby Sharing](/nearby-sharing).
Even though data is encrypted (SSL) when transferred to Uwazi, anyone with access to your Uwazi account or to the server can view the files.
:::

### Testing Uwazi {#testing-uwazi}
Expand Down Expand Up @@ -130,5 +130,5 @@ Then go back to the Uwazi main screen and tap the template you want to use to cr


:::tip
If you need a fully offline way to share files with others, consider exploring [Nearby Sharing](/nearby-sharing).
If you need to share files with others without an internet connection, check out [Nearby Sharing](/nearby-sharing).
:::
4 changes: 2 additions & 2 deletions docs/Discover Tella/accessibility.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,10 +34,10 @@ In this table you can access our latest accessibility reports for each platform.
We are currently working on solving all the A Level accessibility issues detected in Tella Android.

### Offline accessibility {#offline-accessibility}
Tella does not need internet for collecting or storing files, not to use any of the security features. [Connections](/connections) are offline-first, with built in mechanisms for [retrying and re-submitting reports](/features#offline-data-collection) if internet is not readily available. Tella also offers a fully [offline file sharing feature](/nearby-sharing) designed for areas facing internet shutdowns.
Tella does not need internet for collecting or storing files, nor to use any of the security features. [Connections](/connections) are offline-first, with built in mechanisms for [retrying and re-submitting reports](/features#offline-data-collection) if internet is not readily available or if the connection is unstable. Tella also offers a fully [offline file-sharing feature](/nearby-sharing) designed for areas facing internet shutdowns or without connectivity.


### Device accessibility {#device-accessibility}
We implement each feature trying to maximize device accessibility, even for older devices. [Read here about what phones support Tella](/faq#what-phones-support-tella). We also keep Tella as small as possible, to allow people with little storage space available on their phone to [download it and configure it to reduce the used storage space, in case that's a constraint for them](/faq/#how-much-storage-do-i-need-to-install-tella).
We implement each feature trying to maximize device accessibility, even for older devices. [Read here about what phones support Tella](/faq#what-phones-support-tella). We also keep the size of the app as small as possible to [make it accessible to people with little storage space available](/faq/#how-much-storage-do-i-need-to-install-tella).