<commit_before>Upgrading Synapse
=================

Before upgrading check if any special steps are required to upgrade from the
what you currently have installed to current version of synapse. The extra
instructions that may be required are listed later in this document.

If you installed synapse in a virtualenv then active that virtualenv before
upgrading. If synapse is installed in a virtualenv in ``~/.synapse/`` then run:

.. code:: bash

    source ~/.synapse/bin/activate

If you installed synapse using pip then upgrade to the latest version by
running:

.. code:: bash

    pip install --upgrade --process-dependency-links https://github.com/matrix-org/synapse/tarball/master

If you installed synapse using git then upgrade to the latest version by
running:

.. code:: bash

    # Pull the latest version of the master branch.
    git pull
    # Update the versions of synapses python dependencies.
    python synapse/python_dependencies.py | xargs -n1 pip install



Upgrading to v0.9.0
===================

Application services have had a breaking API change in this version.

They can no longer register themselves with a home server using the AS HTTP API. This
decision was made because a compromised application service with free reign to register
any regex in effect grants full read/write access to the home server if a regex of ``.*``
is used. An attack where a compromised AS re-registers itself with ``.*`` was deemed too
big of a security risk to ignore, and so the ability to register with the HS remotely has<commit_msg>Tweak the wording a bit<commit_after>Upgrading Synapse
=================

Before upgrading check if any special steps are required to upgrade from the
what you currently have installed to current version of synapse. The extra
instructions that may be required are listed later in this document.

If synapse was installed in a virtualenv then active that virtualenv before
upgrading. If synapse is installed in a virtualenv in ``~/.synapse/`` then run:

.. code:: bash

    source ~/.synapse/bin/activate

If synapse was installed using pip then upgrade to the latest version by
running:

.. code:: bash

    pip install --upgrade --process-dependency-links https://github.com/matrix-org/synapse/tarball/master

If synapse was installed using git then upgrade to the latest version by
running:

.. code:: bash

    # Pull the latest version of the master branch.
    git pull
    # Update the versions of synapse's python dependencies.
    python synapse/python_dependencies.py | xargs -n1 pip install



Upgrading to v0.9.0
===================

Application services have had a breaking API change in this version.

They can no longer register themselves with a home server using the AS HTTP API. This
decision was made because a compromised application service with free reign to register
any regex in effect grants full read/write access to the home server if a regex of ``.*``
is used. An attack where a compromised AS re-registers itself with ``.*`` was deemed too
big of a security risk to ignore, and so the ability to register with the HS remotely has
{'fraction_non_alphanumeric': 0.07315501127940703, 'fraction_numerical': 0.002578150177247825, 'mean_word_length': 3.9823434991974316, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5026920', 'n_tokens_mistral': 788, 'n_tokens_neox': 743, 'n_words': 437}