SliTaz Doc

Network

A wired connection with DHCP works with no setup: SliTaz brings the network up in the background at boot, so the boot never waits for it. Wi-Fi needs a network name and a key, given once.

Check the connection

$ trame network status
$ trame network check
$ ip addr

trame network check tests the link, the gateway, DNS and internet access, and tells which step fails. The network log is /var/log/network.log.

Wired: DHCP or static address

DHCP on eth0 is the default. To use another interface or a fixed address:

# trame network config interface eth1
# trame network config static 192.168.1.10/24 192.168.1.1 9.9.9.9
# trame network config dhcp
# trame network restart

The static form takes the address with its prefix, the gateway, then one or more DNS servers. trame network dns set changes only the DNS servers. The network can also be restarted with /etc/init.d/network.sh restart.

Wi-Fi

On the desktop, open the quick settings (Ctrl+Super), switch Wi-Fi on and click Networks..., or use the Wi-Fi page of Settings. Choose a network and give its key: it is remembered and joined again at the next boot.

From a terminal:

# trame wifi scan
# trame wifi connect "MyNetwork" - wpa
# trame wifi status
# trame wifi list
# trame wifi forget "MyNetwork"
# trame wifi disconnect

With -, the key is read from the keyboard instead of the command line, so it does not end in the shell history. Enterprise networks (eduroam...) use eap identity=user@domain. Known networks and their keys are stored in /etc/wpa/wpa.conf, readable by root only.

Wi-Fi firmware

If no Wi-Fi interface shows up, the card may need a firmware: trame hardware firmware names it. Install the matching package and reboot:

The Wi-Fi drivers are in linux-lts-wireless, on the desktop images; less common ones (Broadcom, Atheros ath10k...) are in linux-lts-wireless-extra. Recent Realtek (rtw88, rtw89), MediaTek (MT7921, MT7922) and Intel BE200 chips are not supported yet.

Bluetooth

Bluetooth support is a package: install it, then use the quick settings or trame:

# spk-add bluez
# trame bluetooth power on
# trame bluetooth scan
# trame bluetooth pair AA:BB:CC:DD:EE:FF
# trame bluetooth connect AA:BB:CC:DD:EE:FF

Local names (.local)

To reach the machines of your network by name (printer.local) and be found by them, install Avahi:

# spk-add avahi nss-mdns
# /etc/init.d/avahi-daemon start
# trame service enable avahi-daemon

PPPoE

For a modem using PPPoE, install rp-pppoe (on the desktop images already) and run pppoe-setup, then pppoe-start, pppoe-status and pppoe-stop.

Firewall

The firewall service starts at boot on the desktop images. By default it applies kernel protections (no ICMP redirects, no source routing, SYN cookies...) and no packet filtering. To filter the incoming traffic, install iptables, enable the rules and adapt them:

# spk-add iptables
# nano /etc/slitaz/firewall.conf      # IPTABLES_RULES="yes", INTERFACES
# nano /etc/slitaz/firewall.sh        # the rules
# /etc/init.d/firewall restart

The default rules drop the incoming traffic except from the local network, the replies to the connections you open, SSH, FTP, ICMP and the high TCP and UDP ports (1024 and up). A web server on the machine is not reachable from outside until you add a rule for port 80 to firewall.sh. trame firewall allow 22/tcp, deny and list change the running rules only: put permanent rules in firewall.sh.

The network.conf file

All the network settings are in /etc/network.conf, read by /etc/init.d/network.sh at boot:

INTERFACE="eth0"
DHCP="yes"
STATIC="no"
IP="192.168.0.6"
NETMASK="255.255.255.0"
GATEWAY="192.168.0.1"
DNS_SERVER="192.168.0.1"
WIFI="no"
WIFI_INTERFACE="wlan0"

For a static address, set DHCP="no" and STATIC="yes". When WIFI="yes", the Wi-Fi interface is used instead of the wired one. With a static address, routes can be given in /etc/iproute.conf, one ip route add argument line per route, including the default route: the file then replaces GATEWAY. The machine name is in /etc/hostname.