From d5e16a71c6639fc56857506296d8c125e15bed53 Mon Sep 17 00:00:00 2001 From: Matthew Hodgson Date: Fri, 31 Mar 2017 17:00:33 +0100 Subject: [PATCH 1/2] document how to make IPv6 work --- README.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/README.rst b/README.rst index b9c854ad48d0..2ec373ed8147 100644 --- a/README.rst +++ b/README.rst @@ -245,6 +245,24 @@ Setting up a TURN server For reliable VoIP calls to be routed via this homeserver, you MUST configure a TURN server. See ``_ for details. +IPv6 +---- + +As of Synapse 0.19 we finally support IPv6, many thanks to @kyrias and @glyph +for providing PR #1696. + +However, for federation to work on hosts with IPv6 DNS servers you **must** +be running Twisted 17.1.0 or later - see https://github.com/matrix-org/synapse/issues/1002 +for details. We can't make Synapse depend on Twisted 17.1 by default +yet as it will break most older distributions (see https://github.com/matrix-org/synapse/pull/1909) +so to make this work you'll have to manually depend on a newer Twisted. +We assume that anyone wanting to use IPv6 will be comfortable manually installing a +newer Twisted, but you'll want to do something like:: + + pip install Twisted>=17.1.0 + +...in whatever environment (e.g. virtualenv) you've installed synapse within. + Running Synapse =============== From 3bda2189481b2a446f8d58938728b2e5fe9d9dcd Mon Sep 17 00:00:00 2001 From: Matthew Hodgson Date: Tue, 11 Apr 2017 12:19:40 +0100 Subject: [PATCH 2/2] spell out that pip will install 17.1 by default --- README.rst | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/README.rst b/README.rst index 2ec373ed8147..4ed996203b6b 100644 --- a/README.rst +++ b/README.rst @@ -255,13 +255,14 @@ However, for federation to work on hosts with IPv6 DNS servers you **must** be running Twisted 17.1.0 or later - see https://github.com/matrix-org/synapse/issues/1002 for details. We can't make Synapse depend on Twisted 17.1 by default yet as it will break most older distributions (see https://github.com/matrix-org/synapse/pull/1909) -so to make this work you'll have to manually depend on a newer Twisted. -We assume that anyone wanting to use IPv6 will be comfortable manually installing a -newer Twisted, but you'll want to do something like:: +so if you are using operating system dependencies you'll have to install your +own Twisted 17.1 package via pip or backports etc. - pip install Twisted>=17.1.0 +If you're running in a virtualenv then pip should have installed the newest +Twisted automatically, but if your virtualenv is old you will need to manually +upgrade to a newer Twisted dependency via: -...in whatever environment (e.g. virtualenv) you've installed synapse within. + pip install Twisted>=17.1.0 Running Synapse