Commit Graph

685 Commits

Author SHA1 Message Date
Mateusz Mandera cde83e8818 saml: Add documentation about user role/custom profile fields sync.
With substantial rewriting by tabbott, including moving mostly
irrelevant references to very old Zulip versions.
2024-08-20 11:53:24 -07:00
Alex Vandiver dd5b03ea12 wal-g: Support setting the compression method. 2024-08-16 13:57:58 -07:00
Tim Abbott 60eb621477 help: Update documentation for new deletion feature. 2024-08-15 12:03:49 -07:00
Tim Abbott 2144904cf5 docs: Explicitly discuss management commands in Zulip Cloud.
This already seems obvious to many users, but it seems appropriate to
spell out.
2024-08-14 14:04:46 -07:00
Mateusz Mandera aaca394813 presence: Remove the queue worker. 2024-07-31 16:46:42 -07:00
Alex Vandiver 604e328038 docs: Add OS upgrade instructions for 22.04 to 24.04. 2024-07-31 11:56:06 -07:00
Alex Vandiver 5df48dd4d0 docs: Remove an "e.g." when we have explicit steps. 2024-07-31 11:56:06 -07:00
Alex Vandiver 7594d2eecf docs: Document the dialogs shown by needrestart in 22.04. 2024-07-31 11:56:06 -07:00
Alex Vandiver 49a9405aad docs: Document when to restart the server. 2024-07-31 11:56:06 -07:00
Alex Vandiver 5e5478307a docs: Swap upgrade-postgresql steps with rebuilding the venv.
As of 1f68726cb8, the upgrade-postgresql tool uses Python to connect
to the database used by Django, and thus requires a working venv.
There is no reason we cannot reinstall the venv with the old version
of PostgreSQL; swap the steps.
2024-07-31 11:56:06 -07:00
Alex Vandiver e77a425a2b docs: Document supported PostgreSQL versions in 9.x series. 2024-07-31 11:56:06 -07:00
Tim Abbott 54c2c02011 thumbnail: Add support for multiple queue workers.
There's no need for sharding, but this allows one to spend a bit of
extra memory to reduce image-processing latency when bursts of images
are uploaded at once.
2024-07-21 19:15:43 -07:00
Alya Abbott c5d95d4552 docs: Improve mobile push notifications documentation. 2024-07-18 10:15:57 -07:00
Mateusz Mandera 4a93149435 settings: Rework how push notifications service is configured.
Instead of the PUSH_NOTIFICATIONS_BOUNCER_URL and
SUBMIT_USAGE_STATISTICS settings, we want servers to configure
individual ZULIP_SERVICE_* settings, while maintaining backward
compatibility with the old settings. Thus, if all the new
ZULIP_SERVICE_* are at their default False value, but the legacy
settings are activated, they need to be translated in computed_settings
to the modern way.
2024-07-17 17:14:06 -07:00
Alex Vandiver bf9539386a katex: Default the server on.
The memory costs are low (~60MB), and likely worth the stability.
2024-07-15 13:16:31 -07:00
Lauryn Menard 04e2728cb0 documentation: Revise uses of "e.g.," followed by a colon. 2024-07-09 13:41:44 -07:00
Lauryn Menard 32b2eb5f47 documentation: Modify cases of "[a-zA-Z] e\.g\.," for readability. 2024-07-09 13:41:44 -07:00
Lauryn Menard 62d452f983 docs: Add comma to all uses of "e.g." in contributor docs. 2024-07-05 15:36:24 -07:00
Sayam Samal a7772f86a2 docs: Update CZO links from stream to channel in docs and comments.
Updates all the https://chat.zulip.org/#narrow/stream/ links in the
docs and comments to use the new /channel/ path. All these links are
for documentation/reference purposes only and thus, can be bulk-updated.

This commit is a part of the effort to rename stream to channel.
2024-06-11 10:44:31 -07:00
Jason 55d6f809ba docs: Improve STARTTLS / SSL documentation for Django email settings.
Django has some somewhat archaic variable names for configuring SMTP
that are misleading for users not familiar with Django.  Be more
explicit about the correct configuration for both implicit and
explicit TLS.

Co-authored-by: Alex Vandiver <alexmv@zulip.com>
2024-06-05 09:19:31 -07:00
Alex Vandiver 230040caa9 puppet: Remove check_postgresql_backup.
We have replaced this monitoring with the black-box wal-g monitoring,
which is more accurate.
2024-05-24 11:27:59 -07:00
Alex Vandiver 5c2fd1de5a docs: Update Django links to our current version. 2024-05-24 10:18:37 -07:00
Lauryn Menard 42efea4e19 docs: Update `docs/production/` files to use channel.
Updates descriptive text that refer to Zulip channels in the
`docs/production` files to use channel instead of stream.

Part of the stream to channel rename project.
2024-05-20 11:23:23 -07:00
Alex Vandiver a7022bdfec docs: Update for wal-g not being required for replication. 2024-05-07 18:01:07 -07:00
Alex Vandiver 4e15a3969a docs: Document PostgreSQL multiple database host failover.
Added in bd82c6edf9, this is based on libpq's functionality[^1].

[^1]: https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-MULTIPLE-HOSTS
2024-05-07 17:28:10 -07:00
Alex Vandiver 73b760d829 docs: Move warm-standby replication into postgresql.md. 2024-05-07 17:28:10 -07:00
Prakhar Pratyush 422f5c4e1a help: Rename unarchive_stream management command to unarchive_channel. 2024-05-06 11:18:45 -07:00
Prakhar Pratyush b17a006bf0 data_import: Remove gitter data import tool.
Gitter broke their older API as part of being integrated
into Matrix.

Their announcement blog says:
"Anything left using the Gitter APIs will need to be
updated to use the Matrix API"

This commit drops the legacy Gitter import tool and
we plan to build a new one for Matrix in future.
2024-05-02 13:25:25 -07:00
Alya Abbott 480bceae98 docs: Add introduction to video call providers doc.
Also explicitly document the Jitsi integration.
2024-04-29 18:14:40 -07:00
Mateusz Mandera bd00337776 docs: Document new create_guests_without_streams SCIM option.
Documents the little functionality added in
c9ca4e68e5.
2024-04-15 11:16:59 -07:00
Alex Vandiver 44c4b93f6e docs: Improve PostgreSQL documentation.
This removes a bunch of out-of-date documentation which is better
addressed outside of Zulip, and provides more details on running a
PostgreSQL server on a separate host.
2024-04-04 16:50:08 -07:00
Alex Vandiver 7187146422 install: Move PUPPET_CLASSES env var to --puppet-classes argument.
`--no-init-db` is used to silence the need for `--hostname` and
`--email` arguments; it is a proxy for "this is not a frontend host."
We would ideally like to use `has_class` to know if the user's
provided puppet classes are include an `app_frontend`, and thus
`--hostname` and `--email` are required -- but doing that requires
several other steps, and we would like this feedback to be immediate.

We make the presence of `--puppet-classes` equivalent to
`--no-init-db`, since nearly every configuration with
`--puppet-classes` does not install both a database and a frontend,
which is what is required to initialize a database.
2024-04-04 16:49:43 -07:00
Alex Vandiver a69e690122 puppet: Split out a zulip::profile::standalone_nodb class. 2024-04-04 16:48:58 -07:00
Alex Vandiver 65f1f83dac docs: Factor out PostgreSQL support matrix. 2024-04-04 16:48:58 -07:00
Anders Kaseorg 9e7bf865cd docs: Update current PostgreSQL version.
Signed-off-by: Anders Kaseorg <anders@zulip.com>
2024-04-01 16:14:01 -07:00
Anders Kaseorg 70914b0475 Remove support for Ubuntu 20.04 and Debian 11.
Signed-off-by: Anders Kaseorg <andersk@mit.edu>
2024-04-01 13:27:39 -07:00
Alya Abbott 2514093688 docs and help: Update text of no-content mobile notifications.
Documentation follow-up to d9c5eb1280.
2024-03-22 18:16:24 -07:00
Alex Vandiver 23504308fb puppet: Install the same version of postgres-client as the server.
We require a `pg_dump` whose version matches the version of the server
we are configured against (see 3a8b4b0205).  Installing the latest
`postgresql-client` does not guarantee that we have such a binary
present.
2024-03-21 12:34:34 -07:00
Alex Vandiver c129b1779f wal-g: Add support for incremental backups.
This only defaults to on for local-disk backups, since they are more
disk-size-sensitive, and local accesses are quite cheap compared to
loading multiple incremental backups from S3.
2024-03-19 09:58:58 -07:00
Alex Vandiver d726f87035 puppet: Remove backups cron job if they are no longer enabled. 2024-03-19 09:58:58 -07:00
Alex Vandiver 44ff1c24df wal-g: Provide a to-local-disk backup option. 2024-03-19 09:58:58 -07:00
Alex Vandiver 6fc3357a88 docs: Mention concurrency and storage class S3 backup settings. 2024-03-19 09:58:58 -07:00
Alex Vandiver d24fec702f docs: Indent code blocks which are part of bulleted lists.
This makes the subsequent bullet resume its numbering correctly.
2024-03-19 09:58:58 -07:00
Alex Vandiver c13e3dee24 katex: Replace subprocess call with minimal external service.
Replace a separate call to subprocess, starting `node` from scratch,
with an optional standalone node Express service which performs the
rendering.  In benchmarking, this reduces the overhead of a KaTeX call
from 120ms to 2.8ms.  This is notable because enough calls to KaTeX in
a single message would previously time out the whole message
rendering.

The service is optional because he majority of deployments do not use
enough LaTeX to merit the additional memory usage (60Mb).

Fixes: #17425.
2024-03-15 15:34:12 -07:00
Alya Abbott 6eefd07c81 docs: Add plan sign-up to mobile notifications sign-up instructions. 2024-03-05 14:55:24 -08:00
Anders Kaseorg 066ea3ebf9 install: Support Ubuntu 24.04.
Signed-off-by: Anders Kaseorg <anders@zulip.com>
2024-03-01 17:38:08 -08:00
Tim Abbott c1269f1038 docs: Better document backup/export tool tradeoffs.
- More consistent export/import vs backup bullets at the top.

- Remove misleading documentation regarding the `zulip_org_id` reuse
  problems. This documentation was written for Zulip 2.1.0 in
  c6fe6cf0a4 and largely made obsolete
  in d800ac33a0 (Zulip 5.0).

- Light editing for readability/crispness.

Fixes #28925.
2024-03-01 16:17:20 -08:00
Tim Abbott c0e88ad0ea docs: Fix broken Markdown links from recent reorganization.
Introduced in 2b95068406.
2024-02-29 18:11:55 -08:00
Alex Vandiver 8673f87907 puppet: Allow enabling "stats sizes" in memcached. 2024-02-23 13:32:04 -08:00
Alya Abbott 77ab7d810e docs: Move installation troubleshooting section to troubleshooting.md. 2024-02-20 22:26:11 -08:00