Skip to content

Commit 94bc7aa

Browse files
committed
better atomic support in documentation
1 parent e600f98 commit 94bc7aa

File tree

1 file changed

+33
-0
lines changed

1 file changed

+33
-0
lines changed

README.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -100,6 +100,39 @@ sudo systemctl enable --now pcscd
100100

101101
> **Note:** Unlike the `.deb` and `.rpm` packages, the tar.gz installation requires manual setup of the PC/SC daemon. If you see "No readers found", ensure `pcscd` is running (`systemctl status pcscd`).
102102
103+
**Atomic Linux Distributions (Fedora Silverblue, Kinoite, etc.) with Distrobox:**
104+
105+
For immutable/atomic distributions, you can run NFC Agent inside a distrobox container while applying kernel fixes on the host OS:
106+
107+
1. **On the host OS** - Apply the kernel module blacklist (required for ACR122U and similar readers):
108+
```bash
109+
# Create blacklist file on the host
110+
echo -e "blacklist pn533_usb\nblacklist pn533\nblacklist nfc" | sudo tee /etc/modprobe.d/blacklist-pn533.conf
111+
112+
# Unload modules if currently loaded
113+
sudo modprobe -r pn533_usb pn533 nfc 2>/dev/null || true
114+
115+
# Restart PC/SC daemon on host
116+
sudo systemctl restart pcscd
117+
```
118+
119+
2. **Inside distrobox** - Install the package:
120+
```bash
121+
# Enter your distrobox container (e.g., Fedora-based)
122+
distrobox enter fedora
123+
124+
# Install the RPM package
125+
sudo dnf install ./NFC-Agent-*.rpm
126+
```
127+
128+
3. **Run from distrobox** - Start NFC Agent from within the container:
129+
```bash
130+
distrobox enter fedora
131+
nfc-agent
132+
```
133+
134+
> **Note:** The kernel module blacklist must be applied on the host OS because the kernel is shared between the host and containers. The pcscd service also runs on the host and is accessible from within distrobox.
135+
103136
## Quick Start
104137

105138
1. **Connect** your NFC reader via USB

0 commit comments

Comments
 (0)