Configuration

Setup wizard (setup.sh)

The setup.sh script is the easiest way to configure Catsplash. It offers an interactive menu with the following options:

1. Configure and Install (Wizard): Step-by-step guide for installing dependencies, selecting interfaces, configuring WiFi, and creating systemd services.
2. Start/Stop/Restart Services: Control hostapd, dnsmasq and Catsplash.
3. View Status: Shows active services and database sessions.
4. View Logs: Latest Catsplash log lines.
5. Uninstall: Restores original configurations and removes files.

sudo ./setup.sh

It also accepts direct commands:

sudo ./setup.sh start
sudo ./setup.sh stop
sudo ./setup.sh status
sudo ./setup.sh logs
sudo ./setup.sh uninstall

TOML configuration file

The configuration file (/opt/catsplash/config.toml) is auto-generated by the wizard.

Network interfaces

Catsplash requires two interfaces:

• AP (Access Point): WiFi interface that broadcasts the hotspot.
• WAN: Interface with Internet access (eth0, enp1s0, etc.).

systemd services

The wizard creates four systemd services:

• catsplash-ip.service: Assigns the static IP to the hotspot.
• hostapd.service: WiFi access point.
• dnsmasq.service: DHCP and DNS for clients.
• catsplash.service: The captive portal itself.

sudo systemctl status catsplash
sudo journalctl -u catsplash -f

Advanced network configuration

For manual hostapd and dnsmasq configuration, see:

• Advanced Network Setup
• WiFi Security (WPA2)
• Troubleshooting