Tella Web Connection
Tella Web is an open-source tool that enables individuals and organizations to centralize and manage reports sent by Tella users, including photos, videos, and audio files.
Tella Web is developed internally by our team at Horizontal, the same team responsible for developing Tella's mobile apps. It is a user-friendly solution for backing up media files to a remote server in a safe and private manner. Using a Tella Web server also allows users to pull data (guides, instructions, important messages etc) from the server directly to their Tella
We can provide support for the installation, configuration, and maintenance of a Tella Web instance if you don't have someone within your organization who can do it.
Similarly to all other connections(Uwazi, Google Drive, Nextcloud and Open Data Kit), connecting to Tella Web enhances the security of data collected on Tella by:
- Allowing users to collect data directly inside Tella's encrypted container.
- Ensuring that data is sent directly from Tella to Tella Web, without having to rely on a third-party tool or app.
- Allowing users to back up their data on a remote server, to lower the risk that data is discovered on their mobile device.
- 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.
Tella Web is a great option to collect "reports" from users. Reports can include photos, videos, audio recordings, pdf documents and text. Organizations can also upload PDFs to each Tella Web project and users can access these resources directly from their Tella vault.
Setting up Tella Web involves three steps, which are thoroughly discussed in this section:
- Install Tella Web: This step entails installing the Tella Web server and configuring the domain name to ensure its proper functioning.
- Set up your project(s) on your server: In this step, admins decide how to organize themselves to collect data, create "projects", add "resources" for users to download on their devices and set roles and permissions for users.
- 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.
When to Use Tella Web
The Tella Web could be a good alternative if:
- You have the capacity to self-host Tella Web.
- People on the ground will be sending mostly media files, with some text and don't need structured data collection (forms).
- You will be partnering with Horizontal and you want the same organization to help you with installation, configuration, and maintenance of your Tella Web instance and the Tella apps.
If you need help figuring out if Tella Web is best for your use-case, read our guide or contact us!
Install the server
This step consists of installing and configuring Tella Web on the server your organization will be using. This step needs to be completed by the person who is going to be responsible for the system administration (a developer or a system administrator). Technical instructions can be found on our Github.
You can check Tella Web release notes here.
Our team can offer support with the installation, configuration, and maintenance of Tella Web. If you have any question or need support, contact us.
Contact us to get access to our demo server, so you can test Tella Web before installing it on your own server.
Set up your project on your server
Once Tella Web is installed and the first "admin" user created, it’s time to set up the project or projects that the team in the field will share information to.
Take a look at this video tutorial for a demo of how to set up Tella Web.
Admin center
Admins of the Tella Web space can enable or disable system-wide settings depending on their own risk assessment and privacy consideration:
- Opt-in to share analytics with Tella team.
- Suspicious login detection:
- If enabled Tella Web will record location for each login IP and approximate location based on IP. If the user is connecting from an unusual location Tella Web will block the login attempt to prevent any unauthorized sing-in and send an email to the user to confirm if was a legitimate login attempt.
- We use a third party service to calculate the country of the IP.
- Tella Web requires an SMTP server to be properly configured and working for this feature to work.
- If disabled Tella Web won't store the IP, won't calculate location nor ping any third party service.
- Feedback:
- When enabled, Tella Web shows a feedback box that allow users to send an anonymous note to the Tella team on any feedback request or bug reports that they might find. It doesn't contain any information about the user or the Tella Web instance.
- To ensure user privacy and anonymity, only essential data is transmitted to our Feedback server through HTTPS POST requests. Logs containing user information (IP address, date and time, and user-agent) are automatically deleted weekly.
- On the Feedback server database, we only store a copy of the text sent by users in the feedback form and which platform it came from (in this case from "Tella Web" without specifying which server installation).
Managing Projects
Tella Web allows you to create and manage projects, ensuring your reports are organized and accessible.
Projects function like folders where Tella users can submit reports. For instance, you can create projects for specific geographic areas or themes such as police violence, gender-based violence, and environmental abuse.
Each project has its own URL, so a Tella user can be connected to multiple Tella Web projects.
View all available projects
Click on the "Projects" button in the left navigation menu to access the "Projects" screen.
The "Projects" screen displays each existing project as a card.
Create a New Project
On the "Projects" screen, click the "Create project" button. A modal will appear, prompting you to name the new project. Enter the desired name for the project and click "Create." You will be redirected to the "Project settings" screen for the newly created project.
Open a Project
Open the "Projects" screen and click on the desired project card.
This will open the project, where you can access all the reports submitted to the project.
You can open, delete, or download reports (depending on your permissions for this specific project).
Configure projects’ settings
In the "Project settings" screen, you can configure the project:
- The "General" section allows you to rename the project, view project details, and modify the project's URL.
- The "Manage access" section enables you to add or remove users from the project. More info on user roles here
- The "Danger zone" section provides options to delete the project, including all the reports within it.
Delete a Project
In the "Project settings" screen, scroll down to the "Danger zone" section.
Click on the "Delete project" option.
A modal will appear, warning you about the permanent deletion of the project and all its reports. To proceed with the deletion, enter the name of the project correctly (including the right case). Type "DELETE" (in capital letters) to confirm the deletion.
Once confirmed, the project and all its associated reports will be permanently deleted.
Configure the project URL
The project URL is automatically generated when the project is created. To edit the project URL, go to the "General" section in the "Project settings" screen and modify it accordingly. This URL is the one that reporters will use to connect to the project from their apps.
The URL that you'll need to send to the users should look like this https://your-domain.com/p/your-project-name