relay/doc/tool/lxc_test_en.md

Testing with LXC

To test the relay setup in a local LXC container (tested on Arch Linux host):

1. Host Preparation

Install the necessary packages:

sudo pacman -S lxc arch-install-scripts dnsmasq

2. Network Configuration

If your host system has IPv6 disabled, you must disable it for LXC as well to avoid service failures: Edit /etc/default/lxc-net and ensure these lines exist:

USE_LXC_BRIDGE="true"
LXC_IPV6_ENABLE="false"
LXC_IPV6_NAT="false"

Note: If port 53 is occupied (e.g., by dnscrypt-proxy), you may need to configure your DNS service to listen only on 127.0.0.1 so LXC's dnsmasq can bind to the bridge.

Restart the network:

sudo systemctl enable --now lxc-net.service

3. Create and Prepare Container

Create a Debian 12 (bookworm) container:

sudo lxc-create -n test -t download -- -d debian -r bookworm -a amd64
sudo lxc-start -n test

Sync your local repository to the container:

sudo rsync -av --exclude=.git ./ /var/lib/lxc/test/rootfs/relay-ir/

4. Run Deployment

Attach to the container and run the deployment locally:

sudo lxc-attach -n test -- bash -c "cd /relay-ir && ./scripts/initenv.sh && ./scripts/cmdeploy run --ssh-host @local --skip-dns-check"