Skip to content

Commit

Permalink
Browsertrix Cloud → Browsertrix text rename (#1466)
Browse files Browse the repository at this point in the history
Part of #1241

### Changes
- Renames all instances of "Browsertrix Cloud" to "Browsertrix" on the
front end, emails, and documentation

---------

Co-authored-by: emma <hi@emma.cafe>
  • Loading branch information
Shrinks99 and emma-sg committed Mar 12, 2024
1 parent 08f6847 commit 8ba29ca
Show file tree
Hide file tree
Showing 22 changed files with 69 additions and 69 deletions.
4 changes: 2 additions & 2 deletions .github/ISSUE_TEMPLATE/bug.yml
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ body:
- type: input
id: version
attributes:
label: Browsertrix Cloud Version
label: Browsertrix Version
description: This can be found in the site footer
placeholder: "v1.5.0-beta.0-67d0c6a"
validations:
Expand Down Expand Up @@ -38,6 +38,6 @@ body:
- type: textarea
attributes:
label: Additional details
description: Add any other relevant information here, such as your local environment if you are running Browsertrix Cloud locally.
description: Add any other relevant information here, such as your local environment if you are running Browsertrix locally.
validations:
required: false
18 changes: 9 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,37 +1,37 @@
# Browsertrix Cloud
# Browsertrix

<p align="center"><img src="/frontend/assets/btrix-cloud.svg" width="128" height="128"></p>

Browsertrix Cloud is an open-source cloud-native high-fidelity browser-based crawling service designed
Browsertrix is an open-source cloud-native high-fidelity browser-based crawling service designed
to make web archiving easier and more accessible for everyone.

The service provides an API and UI for scheduling crawls and viewing results,
and managing all aspects of crawling process. This system provides the orchestration and management around crawling,
while the actual crawling is performed using
[Browsertrix Crawler](https://github.com/webrecorder/browsertrix-crawler) containers, which are launched for each crawl.

See [Browsertrix Cloud](https://browsertrix.com) for a feature overview and information about Browsertrix Cloud Hosting.
See [browsertrix.com](https://browsertrix.com) for a feature overview and information about Browsertrix Hosting.

## Documentation

The full docs for using, deploying and developing Browsertrix Cloud are available at: [https://docs.browsertrix.cloud](https://docs.browsertrix.cloud)
The full docs for using, deploying and developing Browsertrix are available at: [https://docs.browsertrix.cloud](https://docs.browsertrix.cloud)

## Deployment

The latest deployment documentation is available at: [https://docs.browsertrix.cloud/deploy](https://docs.browsertrix.cloud/deploy)

The docs cover deploying Browsertrix Cloud in different environments using Kubernetes, from a single-node setup to scalable clusters in the cloud.
The docs cover deploying Browsertrix in different environments using Kubernetes, from a single-node setup to scalable clusters in the cloud.

Previously, Browsertrix Cloud also supported Docker Compose and podman-based deployment. This is now deprecated due to the complexity
Previously, Browsertrix also supported Docker Compose and podman-based deployment. This is now deprecated due to the complexity
of maintaining feature parity across different setups, and with various Kubernetes deployment options being available and easy to deploy, even on a single machine.

Making deployment of Browsertrix Cloud as easy as possible remains a key goal, and we welcome suggestions for how we can further improve our Kubernetes deployment options.
Making deployment of Browsertrix as easy as possible remains a key goal, and we welcome suggestions for how we can further improve our Kubernetes deployment options.

If you are looking to just try running a single crawl, you may want to try [Browsertrix Crawler](https://github.com/webrecorder/browsertrix-crawler) first to test out the crawling capabilities.

## Development Status

Browsertrix Cloud is currently in a beta, though the system and backend API is fairly stable, we are working on many additional features.
Browsertrix is currently in a beta, though the system and backend API is fairly stable, we are working on many additional features.

Additional developer documentation is available at [https://docs.browsertrix.cloud/develop](https://docs.browsertrix.cloud/develop/)

Expand All @@ -40,6 +40,6 @@ Please see the GitHub issues and [this GitHub Project](https://github.com/orgs/w

## License

Browsertrix Cloud is made available under the AGPLv3 License.
Browsertrix is made available under the AGPLv3 License.

Documentation is made available under the Creative Commons Attribution 4.0 International License
18 changes: 9 additions & 9 deletions chart/email-templates/invite
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
Welcome to Browsertrix Cloud!
Welcome to Browsertrix!
~~~
<html>
<body>
<p>Hello!</p>

<p>Welcome to Browsertrix Cloud!</p>
<p>Welcome to Browsertrix!</p>

{% if sender %}
<p>You have been invited by {{ sender }} to join "{{ org_name }}" on Browsertrix Cloud!
<p>You have been invited by {{ sender }} to join "{{ org_name }}" on Browsertrix!
</p>
{% endif %}

Expand All @@ -22,11 +22,11 @@ Welcome to Browsertrix Cloud!
<p>When you first access your account, you’ll be directed to your Dashboard. It contains information you may want to view frequently including: Storage Usage, Crawling Info, Collections, and Monthly Usage History. From there, you can click <i>+ Create New</i> to create your first Crawl Workflow!


<p>For more info, check out the <b><a href="https://docs.browsertrix.cloud/user-guide/">Browsertrix Cloud User Guide</a></b></p>
<p>For more info, check out the <b><a href="https://docs.browsertrix.cloud/user-guide/">Browsertrix User Guide</a></b></p>


<p>
We want you to get the most from your Browsertrix Cloud experience!
We want you to get the most from your Browsertrix experience!
</p>

<p>Let us know if you need any questions or feedback.</p>
Expand All @@ -39,10 +39,10 @@ You can connect with our team at <a href="mailto:{{ support_email }}">{{ support
~~~
Hello!

Welcome to Browsertrix Cloud!
Welcome to Browsertrix!

{% if sender %}
You have been invited by {{ sender }} to join their organization, "{{ org_name }}" on Browsertrix Cloud!
You have been invited by {{ sender }} to join their organization, "{{ org_name }}" on Browsertrix!

{% else %}

Expand All @@ -51,13 +51,13 @@ You can join by clicking here: {{ invite_url }}

When you first access your account, you’ll be directed to your Dashboard. It contains information you may want to view frequently including: Storage Usage, Crawling Info, Collections, and Monthly Usage History.

For more info, check out Browsertrix Cloud User Guide at: https://docs.browsertrix.cloud/user-guide/
For more info, check out Browsertrix User Guide at: https://docs.browsertrix.cloud/user-guide/


If you ever need to reset your password, go here: {{ origin }}/log-in/forgot-password


We want you to get the most from your Browsertrix Cloud experience. Let us know if you need any questions or feedback.
We want you to get the most from your Browsertrix experience. Let us know if you need any questions or feedback.
You can connect with our team at {{ support_email }}.


Expand Down
4 changes: 2 additions & 2 deletions chart/email-templates/validate
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
Welcome to Browsertrix Cloud, Verify your Registration.
Welcome to Browsertrix, Verify your Registration.
~~~
Please verify your registration for Browsertrix Cloud for {{ receiver_email }}
Please verify your registration for Browsertrix for {{ receiver_email }}

You can verify by clicking here: {{ origin }}/verify?token={{ token }}

Expand Down
2 changes: 1 addition & 1 deletion docs/deploy/ansible/digitalocean.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

*Playbook Path: [ansible/playbooks/install_microk8s.yml](https://github.com/webrecorder/browsertrix-cloud/blob/main/ansible/playbooks/do_setup.yml)*

This playbook provides an easy way to install Browsertrix Cloud on DigitalOcean. It automatically sets up Browsertrix with LetsEncrypt certificates.
This playbook provides an easy way to install Browsertrix on DigitalOcean. It automatically sets up Browsertrix with LetsEncrypt certificates.

### Requirements

Expand Down
4 changes: 2 additions & 2 deletions docs/deploy/ansible/k3s.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

*Playbook Path: [ansible/playbooks/install_k3s.yml](https://github.com/webrecorder/browsertrix-cloud/blob/main/ansible/playbooks/install_k3s.yml)*

This playbook provides an easy way to install Browsertrix Cloud on a Linux box (tested on Rocky Linux 9). It automatically sets up Browsertrix with Let's Encrypt certificates.
This playbook provides an easy way to install Browsertrix on a Linux box (tested on Rocky Linux 9). It automatically sets up Browsertrix with Let's Encrypt certificates.

### Requirements

Expand All @@ -29,7 +29,7 @@ cp -r ansible/inventory/sample-k3s ansible/inventory/my-deployment

2. Change the [hosts IP address](https://github.com/webrecorder/browsertrix-cloud/blob/main/ansible/inventory/sample-k3s/hosts.ini) in your just created inventory

4. You may need to make modifications to the playbook itself based on your configuration. The playbook lists sections that can be removed or changed based on whether you'd like to install a multi-node or single-node k3s installation for your Browsertrix Cloud deployment. By default the playbook assumes you'll run in a single-node environment deploying directly to `localhost`
4. You may need to make modifications to the playbook itself based on your configuration. The playbook lists sections that can be removed or changed based on whether you'd like to install a multi-node or single-node k3s installation for your Browsertrix deployment. By default the playbook assumes you'll run in a single-node environment deploying directly to `localhost`

5. Run the playbook:
```zsh
Expand Down
2 changes: 1 addition & 1 deletion docs/deploy/ansible/microk8s.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

*Playbook Path: [ansible/playbooks/install_microk8s.yml](https://github.com/webrecorder/browsertrix-cloud/blob/main/ansible/playbooks/install_microk8s.yml)*

This playbook provides an easy way to install Browsertrix Cloud on Ubuntu (tested on Jammy Jellyfish) and RedHat 9 (tested on Rocky Linux 9). It automatically sets up Browsertrix with Letsencrypt certificates.
This playbook provides an easy way to install Browsertrix on Ubuntu (tested on Jammy Jellyfish) and RedHat 9 (tested on Rocky Linux 9). It automatically sets up Browsertrix with Letsencrypt certificates.

### Requirements

Expand Down
10 changes: 5 additions & 5 deletions docs/deploy/index.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
# Deploying Browsertrix Cloud
# Deploying Browsertrix

Browsertrix Cloud is designed to be a cloud-native application running in Kubernetes.
Browsertrix is designed to be a cloud-native application running in Kubernetes.

However, despite the name, it is perfectly reasonable (and easy!) to deploy Browsertrix Cloud locally using one of the many available local Kubernetes options.
However, despite the name, it is perfectly reasonable (and easy!) to deploy Browsertrix locally using one of the many available local Kubernetes options.

The main requirements for Browsertrix Cloud are:
The main requirements for Browsertrix are:

- A Kubernetes Cluster
- [Helm 3](https://helm.sh/) (package manager for Kubernetes)


We have prepared a [Local Deployment Guide](local.md) which covers several options for testing Browsertrix Cloud locally on a single machine, as well as a [Production (Self-Hosted and Cloud) Deployment](remote.md) guide to help with setting up Browsertrix Cloud in different production scenarios. Information about configuring storage, crawler channels, and other details in local or production deployments is in the [Customizing Browsertrix Deployment Guide](customization.md).
We have prepared a [Local Deployment Guide](local.md) which covers several options for testing Browsertrix locally on a single machine, as well as a [Production (Self-Hosted and Cloud) Deployment](remote.md) guide to help with setting up Browsertrix in different production scenarios. Information about configuring storage, crawler channels, and other details in local or production deployments is in the [Customizing Browsertrix Deployment Guide](customization.md).
22 changes: 11 additions & 11 deletions docs/deploy/local.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# Local Deployment

To try out the latest release of Browsertrix Cloud on your local machine, you'll first need to have a working Kubernetes cluster.
To try out the latest release of Browsertrix on your local machine, you'll first need to have a working Kubernetes cluster.

## Installing Kubernetes

Before running Browsertrix Cloud, you'll need to set up a running [Kubernetes](https://kubernetes.io/) cluster.
Before running Browsertrix, you'll need to set up a running [Kubernetes](https://kubernetes.io/) cluster.

Today, there are numerous ways to deploy Kubernetes fairly easily, and we recommend trying one of the single-node options, which include Docker Desktop, microk8s, minikube, and k3s.

Expand All @@ -16,7 +16,7 @@ Here are some environment specific instructions for setting up a local cluster f

??? info "Docker Desktop (recommended for macOS and Windows)"

For macOS and Windows, we recommend testing out Browsertrix Cloud using Kubernetes support in Docker Desktop as that will be one of the simplest options.
For macOS and Windows, we recommend testing out Browsertrix using Kubernetes support in Docker Desktop as that will be one of the simplest options.

1. [Install Docker Desktop](https://www.docker.com/products/docker-desktop/) if not already installed.

Expand Down Expand Up @@ -54,9 +54,9 @@ Here are some environment specific instructions for setting up a local cluster f

3. Set `KUBECONFIG` to point to the config for K3S: `export KUBECONFIG=/etc/rancher/k3s/k3s.yaml` to ensure Helm will use the correct version.

## Launching Browsertrix Cloud with Helm
## Launching Browsertrix with Helm

Once you have a running Kubernetes cluster with one of the options above, and Helm 3 installed, install the latest release of Browsertrix Cloud directly from the latest GitHub release.
Once you have a running Kubernetes cluster with one of the options above, and Helm 3 installed, install the latest release of Browsertrix directly from the latest GitHub release.

<insert-version></insert-version>

Expand All @@ -80,7 +80,7 @@ https://github.com/webrecorder/browsertrix-cloud/releases/download/VERSION/brows
**Note:** Subsequent commands will also use `microk8s helm3` instead of `helm`.


The default setup includes the full Browsertrix Cloud system, with frontend, backend api, db (via MongoDB), and storage (via Minio)
The default setup includes the full Browsertrix system, with frontend, backend api, db (via MongoDB), and storage (via Minio)

An admin user with name `admin@example.com` and password `PASSW0RD!` will be automatically created.

Expand All @@ -100,7 +100,7 @@ helm upgrade --install btrix https://github.com/webrecorder/browsertrix-cloud/re
-f ./chart/examples/local-config.yaml
```

The above examples assumes running from a cloned Browsertrix Cloud repo, however the config file can be saved anywhere and specified with `-f <extra-config.yaml>`.
The above examples assumes running from a cloned Browsertrix repo, however the config file can be saved anywhere and specified with `-f <extra-config.yaml>`.


## Waiting for Cluster to Start
Expand All @@ -117,7 +117,7 @@ REVISION: 1
TEST SUITE: None
```

After that, especially on first run, it may take a few minutes for the Browsertrix Cloud cluster to start, as all images need to be downloaded locally.
After that, especially on first run, it may take a few minutes for the Browsertrix cluster to start, as all images need to be downloaded locally.

You can try running the following command to wait for all pods to be initialized:

Expand All @@ -127,7 +127,7 @@ kubectl wait --for=condition=ready pod --all --timeout=300s

The command will exit when all pods have been loaded, or if there is an error and it times out.

If the command succeeds, you should be able to access Browsertrix Cloud by loading: [http://localhost:30870/](http://localhost:30870/) in your browser.
If the command succeeds, you should be able to access Browsertrix by loading: [http://localhost:30870/](http://localhost:30870/) in your browser.

??? info "Minikube (on macOS)"

Expand All @@ -152,7 +152,7 @@ The outputs of these commands are helpful when reporting an issue [on GitHub](ht

## Updating the Cluster

To update the cluster, for example to update to new version `NEWVERSION`, re-run the same command again, which will pull the latest images. In this way, you can upgrade to the latest release of Browsertrix Cloud. The upgrade will preserve the database and current archives.
To update the cluster, for example to update to new version `NEWVERSION`, re-run the same command again, which will pull the latest images. In this way, you can upgrade to the latest release of Browsertrix. The upgrade will preserve the database and current archives.

```shell
helm upgrade --install btrix https://github.com/webrecorder/browsertrix-cloud/releases/download/NEWVERSION/browsertrix-cloud-NEWVERSION.tgz
Expand All @@ -172,4 +172,4 @@ To fully delete all persistent data (db + archives) created in the cluster, run

## Deploying for Local Development

These instructions are intended for deploying the cluster from the latest releases published on GitHub. See [setting up cluster for local development](../develop/local-dev-setup.md) for additional customizations related to developing Browsertrix Cloud and deploying from local images.
These instructions are intended for deploying the cluster from the latest releases published on GitHub. See [setting up cluster for local development](../develop/local-dev-setup.md) for additional customizations related to developing Browsertrix and deploying from local images.
8 changes: 4 additions & 4 deletions docs/deploy/remote.md
Original file line number Diff line number Diff line change
Expand Up @@ -94,15 +94,15 @@ mongo_auth:

## Cloud Deployment

There are also many ways to deploy Browsertrix Cloud on various cloud providers.
There are also many ways to deploy Browsertrix on various cloud providers.

To simplify this process, we are working on Ansible playbooks for setting up Browsertrix Cloud on commonly used infrastructure.
To simplify this process, we are working on Ansible playbooks for setting up Browsertrix on commonly used infrastructure.

### Ansible Deployment

[Ansible](https://ansible.com) makes the initial setup and configuration of your Browsertrix Cloud instance automated and repeatable.
[Ansible](https://ansible.com) makes the initial setup and configuration of your Browsertrix instance automated and repeatable.

To use, you will need to [install Ansible](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html#control-node-requirements) on your control computer and then you can use these to deploy to Browsertrix Cloud on remote and cloud environments.
To use, you will need to [install Ansible](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html#control-node-requirements) on your control computer and then you can use these to deploy to Browsertrix on remote and cloud environments.

Currently, we provide playbooks for the following tested environments:

Expand Down
2 changes: 1 addition & 1 deletion docs/develop/docs.md
Original file line number Diff line number Diff line change
Expand Up @@ -133,7 +133,7 @@ Renders to: `#!python range()`

`Paid Feature`{ .badge-green }

Some features of Browsertrix Cloud only pertain to those paying for the software on a hosted plan. Denote these with the following:
Some features of Browsertrix only pertain to those paying for the software on a hosted plan. Denote these with the following:

```markdown
`Paid Feature`{ .badge-green }
Expand Down
8 changes: 4 additions & 4 deletions docs/develop/frontend-dev.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
# Developing the Frontend UI

This guide explains how to run the Browsertrix Cloud frontend development server with [Yarn](https://classic.yarnpkg.com).
This guide explains how to run the Browsertrix frontend development server with [Yarn](https://classic.yarnpkg.com).

Instead of rebuilding the entire frontend image to view your UI changes, you can use the included local development server to access the frontend from your browser. This setup is ideal for rapid UI development that does not rely on any backend changes.

## Requirements

### 1. Browsertrix Cloud API backend already in a Kubernetes cluster
### 1. Browsertrix API backend already in a Kubernetes cluster

The frontend development server requires an existing backend that has been deployed locally or is in production. See [Deploying Browsertrix Cloud](../deploy/index.md).
The frontend development server requires an existing backend that has been deployed locally or is in production. See [Deploying Browsertrix](../deploy/index.md).

### 2. Node.js ≥16 and Yarn 1

Expand Down Expand Up @@ -64,7 +64,7 @@ API_BASE_URL=http://dev.example.com

!!! note

This setup assumes that your API endpoints are available under `/api`, which is the default configuration for the Browsertrix Cloud backend.
This setup assumes that your API endpoints are available under `/api`, which is the default configuration for the Browsertrix backend.

If connecting to a local deployment cluster, set `API_BASE_URL` to:

Expand Down

0 comments on commit 8ba29ca

Please sign in to comment.