mirror of
https://github.com/zulip/zulip.git
synced 2025-11-03 05:23:35 +00:00
help: Add article about moving to Zulip Cloud from self-hosting.
Adds a help center article that provides an overview and guide for moving from a self-hosted Zulip organization to using Zulip Cloud. Updates the bullet points with the advantages of Zulip Cloud that is also used in the help center article about choosing between Zulip Cloud and self-hosting. Fixes #24042.
This commit is contained in:
Lauryn Menard
committed by
Tim Abbott
Tim Abbott
parent
25627bbb8a
commit
edf787f87d
@@ -1,22 +1,23 @@
|
||||
* All [self-hosted plans](https://zulip.com/plans/#self-hosted) offer the same
|
||||
[100% open-source software] [zulip-github]. Organizations that do not require
|
||||
support with their installation can always use Zulip for free with no
|
||||
limitations.
|
||||
|
||||
* Retain full control over your data and simplify compliance by self-hosting
|
||||
Zulip behind your firewall.
|
||||
|
||||
* We work hard to make it easy to [install][install-zulip], [back
|
||||
up][back-up-zulip], and [maintain][maintain-zulip] a self-hosted
|
||||
Zulip server. Self-host Zulip directly on Ubuntu or Debian Linux, in
|
||||
<a href="https://github.com/zulip/docker-zulip">Docker</a>, or with
|
||||
prebuilt images for <a
|
||||
href="https://marketplace.digitalocean.com/apps/zulip">Digital
|
||||
Ocean</a> and <a
|
||||
href="https://render.com/docs/deploy-zulip">Render</a>.
|
||||
|
||||
* Customize Zulip for all your needs. It's easy to develop and maintain [custom
|
||||
integrations](/api/incoming-webhooks-overview) and [features][modify-zulip].
|
||||
* **Under your control**: Retain full control over your data and simplify
|
||||
compliance by self-hosting Zulip behind your firewall.
|
||||
* **Access to all of Zulip's features**: All [self-hosted
|
||||
plans](https://zulip.com/plans/#self-hosted) offer the same [100% open-source
|
||||
software] [zulip-github]. Organizations that do not require support with their
|
||||
installation can always use Zulip for free with no limitations.
|
||||
* **Simple set-up process**: It's easy to [install][install-zulip] Zulip
|
||||
directly on Ubuntu or Debian Linux, in <a
|
||||
href="https://github.com/zulip/docker-zulip">Docker</a>, or with prebuilt
|
||||
images for <a href="https://marketplace.digitalocean.com/apps/zulip">Digital
|
||||
Ocean</a> and <a href="https://render.com/docs/deploy-zulip">Render</a>.
|
||||
* **Easy to maintain**: Zulip offers convenient tools for [backing
|
||||
up][back-up-zulip], and [maintaining][maintain-zulip] a self-hosted Zulip
|
||||
server.
|
||||
* **Customizable**: Customize Zulip for all your needs. It's easy to develop and
|
||||
maintain [custom integrations](/api/incoming-webhooks-overview) and
|
||||
[features][modify-zulip].
|
||||
* **Budget option**: For organizations with expertise in self-hosting their
|
||||
tools and a tight budget, the [Zulip Basic
|
||||
plan](https://zulip.com/plans/#self-hosted) can be a great choice.
|
||||
|
||||
Learn more about [self-hosting Zulip](https://zulip.com/self-hosting/).
|
||||
|
||||
|
||||
@@ -1,4 +1,14 @@
|
||||
* Simple managed solution, with no setup or maintenance
|
||||
overhead. [Sign up](https://zulip.com/new/) with just a few clicks.
|
||||
* Always updated to the latest version of Zulip.
|
||||
* Anyone can [start with Zulip Cloud Free](https://zulip.com/new/).
|
||||
* **No setup or maintenance overhead:** Zulip Cloud is a simple SaaS solution,
|
||||
so you don't need to set up your own server. It only take a minute to [sign
|
||||
up](https://zulip.com/new/).
|
||||
* **Always up to date:** Zulip Cloud is updated every couple of weeks with the
|
||||
latest version of Zulip. In contrast, new features are
|
||||
[released](https://blog.zulip.com/tag/major-releases/) for self-hosted
|
||||
installations twice a year (with [maintenance
|
||||
releases](https://blog.zulip.com/tag/release-announcements/) in between).
|
||||
* **Operated by experts:** Zulip Cloud is operated by the core team developing
|
||||
Zulip, with deep expertise in running your mission-critical chat software with
|
||||
[minimal downtime](https://status.zulip.com/).
|
||||
* **Free to get started:** [Zulip Cloud Free](https://zulip.com/plans/#cloud)
|
||||
makes it easy to get started, and has all the features you need for casual
|
||||
use.
|
||||
|
||||
@@ -1,11 +0,0 @@
|
||||
Whether [signing up for Zulip Cloud](https://zulip.com/new/) or [self-hosting
|
||||
Zulip](https://zulip.com/self-hosting/) is the right choice for you depends on
|
||||
the needs of your organization.
|
||||
|
||||
If you aren’t sure what you need, our high quality export and import tools
|
||||
([cloud][export-cloud], [self-hosted][export-self-hosted]) ensure you can always
|
||||
move from our hosting to yours (and back). No matter which option you go with,
|
||||
free or heavily discounted pricing is available for most non-business uses.
|
||||
|
||||
[export-cloud]: /help/export-your-organization
|
||||
[export-self-hosted]: https://zulip.readthedocs.io/en/stable/production/export-and-import.html
|
||||
@@ -276,6 +276,7 @@
|
||||
* [Zulip Cloud billing](/help/zulip-cloud-billing)
|
||||
* [Self-hosted billing](/help/self-hosted-billing)
|
||||
* [GDPR compliance](/help/gdpr-compliance)
|
||||
* [Move to Zulip Cloud](/help/move-to-zulip-cloud)
|
||||
* [Support the Zulip project](/help/support-zulip-project)
|
||||
* [Linking to the Zulip website](/help/linking-to-zulip-website)
|
||||
* [Contact support](/help/contact-support)
|
||||
|
||||
137
help/move-to-zulip-cloud.md
Normal file
137
help/move-to-zulip-cloud.md
Normal file
@@ -0,0 +1,137 @@
|
||||
# Move from self-hosting to Zulip Cloud
|
||||
|
||||
With Zulip's high quality import and export tools, you can always
|
||||
move from self-hosting your own Zulip server to using the Zulip
|
||||
Cloud service (and back).
|
||||
|
||||
## Process overview
|
||||
|
||||
To move your Zulip organization from a self-hosted server to Zulip
|
||||
Cloud, you will need to take the following steps, which are described
|
||||
in more detail below:
|
||||
|
||||
{start_tabs}
|
||||
|
||||
1. [Plan the process and coordinate with Zulip support](#plan-the-process-and-coordinate-with-zulip-support).
|
||||
|
||||
1. [Upgrade your self-hosted server](#upgrade-your-self-hosted-server).
|
||||
|
||||
1. [Export organization data](#export-organization-data).
|
||||
|
||||
1. [Decide how users will log in](#decide-how-users-will-log-in).
|
||||
|
||||
{end_tabs}
|
||||
|
||||
## Plan the process and coordinate with Zulip support
|
||||
|
||||
To import your self-hosted organization into Zulip Cloud, your server will need
|
||||
to have the same database format as Zulip Cloud. Zulip Cloud is updated every
|
||||
couple of weeks, so it's important to coordinate the timing with Zulip's support
|
||||
team.
|
||||
|
||||
{start_tabs}
|
||||
|
||||
1. Review the process described on this page, and decide when you will be ready
|
||||
to make the transition.
|
||||
|
||||
1. Email [support@zulip.com](mailto:support@zulip.com) with the following information:
|
||||
- URL of the organization you plan to migrate
|
||||
- Your estimated timeline for generating a data export
|
||||
- Any other timing considerations for the transition (e.g., time of day)
|
||||
- If you're planning to purchase the [Zulip Cloud Plus
|
||||
plan](https://zulip.com/plans), details on the Plus plan features (e.g.,
|
||||
authentication methods) you intend to use. These features will be
|
||||
configured for your organization as part of the import process.
|
||||
|
||||
Zulip's support team will coordinate with you to make the transition with
|
||||
minimal disruption for your team.
|
||||
|
||||
{end_tabs}
|
||||
|
||||
## Upgrade your self-hosted server
|
||||
|
||||
You will need to upgrade your server to use the same database format
|
||||
as Zulip Cloud, using the published `zulip-cloud-current` branch.
|
||||
|
||||
{start_tabs}
|
||||
|
||||
1. [Check](/help/view-zulip-version#view-zulip-server-and-web-app-version) your
|
||||
Zulip server version.
|
||||
|
||||
1. [Upgrade to the latest maintenance
|
||||
release](https://zulip.readthedocs.io/en/stable/production/upgrade.html#upgrading-to-a-release)
|
||||
if you are running an older version of the Zulip server.
|
||||
|
||||
1. [Upgrade](https://zulip.readthedocs.io/en/stable/production/upgrade.html#upgrading-from-a-git-repository)
|
||||
to the `zulip-cloud-current` branch.
|
||||
|
||||
{end_tabs}
|
||||
|
||||
For additional support with upgrading from an older version of Zulip, contact
|
||||
[sales@zulip.com](mailto:sales@zulip.com) for paid support options.
|
||||
|
||||
## Export organization data
|
||||
|
||||
{start_tabs}
|
||||
|
||||
1. Make sure you [have a
|
||||
plan](#plan-the-process-and-coordinate-with-zulip-support) for when the
|
||||
import into Zulip Cloud will take place.
|
||||
|
||||
1. Announce the migration and schedule Zulip downtime for your team.
|
||||
|
||||
1. [Follow these instructions](https://zulip.readthedocs.io/en/stable/production/export-and-import.html#data-export)
|
||||
to export your Zulip data.
|
||||
|
||||
1. Send an email to [support@zulip.com](mailto:support@zulip.com) with:
|
||||
- Your data export.
|
||||
- The subdomain you would like to use for your organization. Your Zulip
|
||||
Cloud organization will be hosted at `<subdomain>.zulipchat.com`.
|
||||
|
||||
Zulip's support team will let you know when the data import process is complete.
|
||||
|
||||
{end_tabs}
|
||||
|
||||
## Decide how users will log in
|
||||
|
||||
When user accounts are imported, users initially do not have passwords
|
||||
configured. There are a few options for how users can log in for the first time.
|
||||
|
||||
!!! tip ""
|
||||
|
||||
For security reasons, passwords are never exported.
|
||||
|
||||
### Allow users to log in with non-password authentication
|
||||
|
||||
Users will immediately be able to log in with [authentication
|
||||
methods](/help/configure-authentication-methods) that do not require a password,
|
||||
if these [authentication methods](/help/configure-authentication-methods) are
|
||||
enabled.
|
||||
|
||||
### Send password reset emails to all users
|
||||
|
||||
You can ask [support@zulip.com](mailto:support@zulip.com) to send password reset
|
||||
emails to all users in your organization, which will allow them to set an
|
||||
initial password.
|
||||
|
||||
!!! warn ""
|
||||
|
||||
To avoid confusion, first make sure that the users in your
|
||||
organization are aware that their account has been moved,
|
||||
and are expecting to receive a password reset email.
|
||||
|
||||
### Manual password resets
|
||||
|
||||
Alternatively, users can reset their own passwords by following the instructions
|
||||
on your Zulip organization's login page.
|
||||
|
||||
## Advantages of Zulip Cloud
|
||||
|
||||
{!advantages-of-zulip-cloud.md!}
|
||||
|
||||
## Related articles
|
||||
|
||||
* [Choosing between Zulip Cloud and self-hosting](/help/zulip-cloud-or-self-hosting)
|
||||
* [Zulip Cloud billing](/help/zulip-cloud-billing)
|
||||
* [Upgrade Zulip server](https://zulip.readthedocs.io/en/stable/production/upgrade.html)
|
||||
* [Zulip data export tool](https://zulip.readthedocs.io/en/stable/production/export-and-import.html#data-export)
|
||||
@@ -1,15 +1,36 @@
|
||||
# Choosing between Zulip Cloud and self-hosting
|
||||
|
||||
{!cloud-vs-self-hosting-intro.md!}
|
||||
This page will help you decide whether [signing up for Zulip
|
||||
Cloud](https://zulip.com/new/) or [self-hosting
|
||||
Zulip](https://zulip.com/self-hosting/) best fits the needs of your
|
||||
organization. For additional guidance, reach out to
|
||||
[sales@zulip.com](mailto:sales@zulip.com).
|
||||
|
||||
!!! tip ""
|
||||
If your needs change, you can always move [to a self-hosted
|
||||
installation](https://zulip.readthedocs.io/en/stable/production/export-and-import.html#import-into-a-new-zulip-server)
|
||||
or [to Zulip Cloud](/help/move-to-zulip-cloud).
|
||||
|
||||
## Advantages of Zulip Cloud
|
||||
|
||||
{!advantages-of-zulip-cloud.md!}
|
||||
|
||||
[Sign up](https://zulip.com/new/) with just a few clicks.
|
||||
|
||||
## Advantages of self-hosting Zulip
|
||||
|
||||
{!advantages-of-self-hosting-zulip.md!}
|
||||
|
||||
## Plans and pricing
|
||||
|
||||
Compare [Zulip Cloud](https://zulip.com/plans#cloud) and [self-hosted
|
||||
Zulip](https://zulip.com/plans#self-hosted) pricing.
|
||||
|
||||
Free or heavily discounted pricing is available for most non-business uses.
|
||||
Learn how to apply for a sponsored
|
||||
[Cloud](https://zulip.com/help/zulip-cloud-billing#free-and-discounted-zulip-cloud-standard) or
|
||||
[self-hosted](https://zulip.com/help/self-hosted-billing#apply-for-community-plan) plan.
|
||||
|
||||
## Related resources
|
||||
|
||||
* [Sign up for Zulip Cloud](https://zulip.com/new/)
|
||||
|
||||
Reference in New Issue
Block a user