Troubleshooting

Common Issues

Error: could not save /etc/hosts. Reason: open /etc/hosts: permission denied

The hosts file requires root/administrator privileges to modify. Use sudo:

sudo txeh add 127.0.0.1 myapp.local

txeh: command not found

The Go binary directory may not be in your $PATH. Add it:

export PATH=$PATH:$(go env GOPATH)/bin

Add this line to your shell profile (~/.bashrc, ~/.zshrc, etc.) to make it permanent.

After adding entries, if the hostname doesn't resolve:

Flush DNS cache. You can do this automatically with txeh --flush (or set TXEH_AUTO_FLUSH=1). See the CLI reference for details. To flush manually:

macOS
```
sudo dscacheutil -flushcache && sudo killall -HUP mDNSResponder
```
Linux (systemd)
```
sudo systemd-resolve --flush-caches
```
Windows
```
ipconfig /flushdns
```
Verify the entry was added:
```
txeh show
```
Check for conflicting entries. Multiple entries for the same hostname may cause unexpected behavior.

txeh auto-detects the Windows hosts file via the SystemRoot environment variable. The default is:

C:\Windows\System32\drivers\etc\hosts

If your Windows installation uses a non-standard path, set SystemRoot or use the --read/--write flags.