Commit b6c669dc authored by sajolida's avatar sajolida
Browse files

Merge branch 'doc/11683-broken-wifi'

parents 0ffc7d8a 13b1f6d3
[[!meta title="Connecting to a network"]]
[[!toc levels=2]]
Connecting to a network
=======================
You can connect to a network using a wired, Wi-Fi, or mobile broadband
connection:
- If a wired connection is detected, Tails automatically connects to it.
1. Open the system menu in the top-right corner.
- To connect to a Wi-Fi network:
[[!img doc/first_steps/introduction_to_gnome_and_the_tails_desktop/system.png link="no"]]
1. Open the system menu in the top-right corner.
- If a wired connection is detected, Tails automatically connects to the network.
1. Choose <span class="guilabel">Wi-Fi</span> and then <span class="guilabel">Select Network</span>.
- To connect to a Wi-Fi network, choose <span class="guilabel">Wi-Fi Not
Connected</span> and then <span class="guilabel">Select Network</span>.
- To connect to a mobile broadband network:
- To connect to a mobile broadband network, choose
<span class="guilabel">Mobile Broadband</span>.
1. Open the system menu in the top-right corner.
<div class="note">
<p>It is currently impossible to connect to a network using:</p>
1. Choose <span class="guilabel">Mobile Broadband</span>.
<ul>
<li>Dial-up modems.</li>
<li>VPNs, see [[the corresponding FAQ|support/faq#vpn]].</li>
</ul>
[[!img doc/first_steps/introduction_to_gnome_and_the_tails_desktop/system.png link="no"]]
</div>
To connect to Tor using bridges or configure a proxy to access the Internet,
you need to [[activate additional Tor configuration when starting Tails|first_steps/startup_options#additional]].
1. After establishing a connection to a network:
- If you can already access the Internet, Tor is automatically started.
- If you need to log in to a captive portal before being granted access to
the Internet, see our documentation on [[logging in to captive
portals|doc/anonymous_internet/unsafe_browser]].
For more information, open
<span class="application">[[GNOME Help|first_steps/introduction_to_gnome_and_the_tails_desktop#help]]</span>
and choose <span class="guilabel">Networking, web, email & chat</span>.
If you are concerned about being identified as a Tails user on your
network, read our documentation about [[network
fingerprinting|doc/about/fingerprint]].
Troubleshooting Wi-Fi not working
=================================
After establishing a connection to a network:
[[!inline pages="doc/anonymous_internet/networkmanager/no-wifi.inline" raw="yes" sort="age"]]
- If you can already access the Internet, Tor is automatically started.
* Check in our list of [[known Wi-Fi issues|support/known_issues#wi-fi-workarounds]]
if there is a workaround to get your Wi-Fi interface to work in Tails.
- If you need to log in to a captive portal before being granted access to
the Internet, then [[see the corresponding documentation|unsafe_browser]].
Using Tor bridges or a local proxy
==================================
To connect to Tor using bridges or configure a proxy to access the Internet,
you need to [[activate additional Tor configuration when starting Tails|first_steps/startup_options#additional]].
Modifying and saving your network settings
==========================================
To modify your network settings, for example to configure whether or not
to automatically connect to a Wi-Fi network, do the following:
......@@ -42,22 +76,3 @@ If you want to reuse your custom
configuration or the passwords of encrypted wireless connections across separate
working sessions, you can activate the [[<span class="guilabel">Network connections</span> persistence
feature|first_steps/persistence/configure#network_connections]].
If you are concerned about being identified as a Tails user on your
network, read our documentation about [[network
fingerprinting|doc/about/fingerprint]].
<div class="note">
<p>It is currently impossible to connect using:</p>
<ul>
<li>Dial-up modems.</li>
<li>VPNs, see [[the corresponding FAQ|support/faq#vpn]].</li>
</ul>
</div>
For more information, open
<span class="application">[[GNOME Help|first_steps/introduction_to_gnome_and_the_tails_desktop#help]]</span>
and choose <span class="guilabel">Networking, web, email & chat</span>.
If your Wi-Fi interface is not working, either:
* There is no Wi-Fi option in the system menu:
[[!img system-without-wi-fi.png link="no" alt=""]]
* The interface is disabled when starting Tails or when plugging in your USB
Wi-Fi adapter:
[[!img mac-spoofing-disabled.png link="no" alt="Notification about network card being disabled"]]
In this case, you can disable MAC spoofing to get your Wi-Fi interface
to work in Tails. Disabling MAC spoofing has security implications, so read
carefully our [[documentation about MAC
spoofing|first_steps/startup_options/mac_spoofing]] before doing so.
To connect to the Internet, you can try to either:
* Use an Ethernet cable instead of Wi-Fi if possible. Wired interfaces work
much more reliably than Wi-Fi in Tails.
* Buy a USB Wi-Fi adapter that works in Tails:
<table>
<tr><th>Vendor</th><th>Model</th><th>Size</th><th>Speed</th><th>Price</th><th>Buy offline</th><th>Buy online</th></tr>
<tr><td>Panda Wireless</td><td>Ultra</td><td>Nano</td><td>150 Mbit/s</td><td>$12</td><td>No</td><td><a href="https://www.amazon.com/d/B00762YNMG/">Amazon</a></td></tr>
<tr><td>Panda Wireless</td><td>PAU05</td><td>Small</td><td>300 Mbit/s</td><td>$14</td><td>No</td><td><a href="https://www.amazon.com/d/B00EQT0YK2/">Amazon</a></td></tr>
<!--
The following USB adapters work as well but don't really have advantages over the ones that are listed already:
<tr><td>Panda Wireless</td><td>Mini</td><td>Large</td><td>150 Mbit/s</td><td>$10</td><td>No</td><td><a href="https://www.amazon.com/d/B003283M6Q/">Amazon</a></td></tr>
<tr><td>Panda Wireless</td><td>N600</td><td>Large</td><td>300 Mbit/s</td><td>$25</td><td>No</td><td><a href="https://www.amazon.com/d/B00U2SIS0O/">Amazon</a></td></tr>
<tr><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
-->
</table>
<div class="note">
<p>If you find another USB Wi-Fi adapter that works in Tails, please let us
know. You can write to [[tails-testers@boum.org|about/contact#tails-testers]]
(public mailing list) or [[tails@boum.org|about/contact#tails]] (private
email).</p>
</div>
Test your Wi-Fi
---------------
Problems with Wi-Fi are unfortunately quite common in Tails and Linux in
general. To test if your Wi-Fi interface works in Tails:
1. Open the system menu in the top-right corner:
[[!img doc/first_steps/introduction_to_gnome_and_the_tails_desktop/system.png link="no"]]
1. Choose <span class="guilabel">Wi-Fi Not Connected</span> and then
<span class="guilabel">Select Network</span>.
1. After establishing a connection to a network:
- If you can already access the Internet, Tor is automatically started.
- If you need to log in to a captive portal before being granted access to
the Internet, see our documentation about [[logging in to captive portals|doc/anonymous_internet/unsafe_browser]].
[[!inline pages="doc/anonymous_internet/networkmanager/no-wifi.inline" raw="yes" sort="age"]]
<div class="trophy">
<div class="state-image debian expert mac-dvd">[[!img install/inc/infography/tails-usb.png link="no" alt="Tails USB stick"]]</div>
......
......@@ -85,7 +85,7 @@ body {
/* The bottom margin of all elements is fixed to a multiple of λ so that they
* don't brake the rythm when they overlap. We set all top margin to 0. */
p {
p, table {
margin: 0 0 1.5em 0; /* 14×1.5=21px=λ */
}
......
......@@ -413,30 +413,22 @@ To improve support of Tails running inside a virtual machine with
Wi-Fi issues
============
<a id="broadcom-sta-dkms"></a>
[[!inline pages="doc/anonymous_internet/networkmanager/no-wifi.inline" raw="yes" sort="age"]]
Broadcom Wi-Fi network interface needing `broadcom-sta-dkms`
------------------------------------------------------------
Some Broadcom Wi-Fi interfaces require the
[`wl`](https://wiki.debian.org/wl) driver, provided by the
`broadcom-sta-dkms` Debian package, to work in Tails.
The `wl` driver is not included in Tails because it is proprietary.
* Check in the following sections
if there is a workaround to get your Wi-Fi interface work in Tails.
To find out if your Wi-Fi interface requires the `wl` driver:
<a id="wi-fi-workarounds"></a>
1. Execute the following command in a [[terminal|doc/first_steps/introduction_to_gnome_and_the_tails_desktop#terminal]]:
Knowing the model of your Wi-Fi interface
-----------------------------------------
lspci -nn | grep Network
1. Open <span class="application">Terminal</span> and execute the following command:
2. Verify if your device is in the list of devices supported by the `broadcom-sta-dkms`
package on the corresponding [Debian wiki page](https://wiki.debian.org/wl).
If you find your device in the list of supported devices, then it is
impossible to use your Wi-Fi card in Tails.
lspci -v | grep "Network controller"
Marvell Avastar 88W8897
-----------------------
88W8897 [AVASTAR] 802.11ac Wireless
-----------------------------------
On some computers with a Marvell Avastar 88W8897 Wi-Fi adapter, such
as some Microsoft Surface Pro models, Tails fails to connect to
......@@ -446,8 +438,8 @@ If you experience this problem, you can try to [[disable MAC address
spoofing|doc/first_steps/startup_options/mac_spoofing]] that sometimes
fixes it.
Systems with RTL8723be Wi-Fi adapter
------------------------------------
RTL8723BE PCIe Wireless Network Adapter
---------------------------------------
On some computers with a RTL8723be Wi-Fi adapter, Tails may fail to discover
Wi-Fi networks, may provide unreliable Wi-Fi connections, or may provide poor
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment