Reorganize repository structure and add configuration management
- Create organized directory structure: - docs/ for all documentation files - config/ for deployment configurations and scripts - Add CLAUDE.md with project architecture and development workflow - Update README.md with new structure and current status - Move all documentation to docs/ directory - Organize Docker and Nginx configurations under config/ 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
312
docs/troubleshooting.md
Normal file
312
docs/troubleshooting.md
Normal file
@@ -0,0 +1,312 @@
|
||||
# Bluetooth keeps disconnecting - reconnecting
|
||||
|
||||
Solution: Change config in /etc/bluetooth/main.conf
|
||||
`ControllerMode = bredr`
|
||||
Then `sudo systemctl restart bluetooth`
|
||||
|
||||
UPDATE: It's still not fixed :(
|
||||
Trying `yay -S pipewire wireplumber`
|
||||
TODO test it again
|
||||
|
||||
# Touchpad scroll direction (libinput)
|
||||
|
||||
To change touchpad scroll direction on Arch Linux using libinput driver:
|
||||
|
||||
## Investigation steps:
|
||||
1. Check which driver is used: `pacman -Q | grep -E "(synaptics|libinput)"`
|
||||
2. Verify libinput config exists: `ls /usr/share/X11/xorg.conf.d/ | grep libinput`
|
||||
|
||||
## Solution for libinput:
|
||||
Create `/etc/X11/xorg.conf.d/30-touchpad.conf`:
|
||||
|
||||
```
|
||||
Section "InputClass"
|
||||
Identifier "touchpad"
|
||||
Driver "libinput"
|
||||
MatchIsTouchpad "on"
|
||||
Option "NaturalScrolling" "true"
|
||||
Option "Tapping" "on"
|
||||
Option "TappingDrag" "on"
|
||||
Option "DisableWhileTyping" "on"
|
||||
EndSection
|
||||
```
|
||||
|
||||
Set `NaturalScrolling` to:
|
||||
- `"true"` for macOS-style (natural) scrolling
|
||||
- `"false"` for traditional scrolling
|
||||
|
||||
Restart X11 (log out/in) or reboot to apply changes.
|
||||
|
||||
## Alternative: Synaptics driver (legacy)
|
||||
|
||||
If using the older synaptics driver instead of libinput:
|
||||
|
||||
### Investigation steps:
|
||||
1. Check for synaptics: `pacman -Q xf86-input-synaptics`
|
||||
2. Look for config: `ls /usr/share/X11/xorg.conf.d/ | grep synaptics`
|
||||
|
||||
### Solution:
|
||||
Create `/etc/X11/xorg.conf.d/70-synaptics.conf`:
|
||||
|
||||
```
|
||||
Section "InputClass"
|
||||
Identifier "touchpad"
|
||||
Driver "synaptics"
|
||||
MatchIsTouchpad "on"
|
||||
MatchDevicePath "/dev/input/event*"
|
||||
Option "VertScrollDelta" "-111"
|
||||
Option "HorizScrollDelta" "-111"
|
||||
Option "TapButton1" "1"
|
||||
Option "TapButton2" "3"
|
||||
Option "TapButton3" "2"
|
||||
Option "PalmDetect" "1"
|
||||
Option "SHMConfig" "on"
|
||||
EndSection
|
||||
```
|
||||
|
||||
Synaptics scroll direction options:
|
||||
- `VertScrollDelta` and `HorizScrollDelta`:
|
||||
- Positive values (e.g., `"111"`) for traditional scrolling
|
||||
- Negative values (e.g., `"-111"`) for natural/reversed scrolling
|
||||
|
||||
**Note:** libinput is the modern standard. Consider switching from synaptics to libinput for better support and features.
|
||||
|
||||
# Theme switching issues
|
||||
|
||||
## Cross-application theme synchronization
|
||||
|
||||
**Issue:** Need to synchronize theme (light/dark) across tmux, nvim, and other terminal applications.
|
||||
|
||||
**Solution:** File-based theme management system using `~/.vim_theme`:
|
||||
|
||||
### Setup:
|
||||
|
||||
1. **Create theme switcher script** (`~/.config/tmux/themeswitch.sh`):
|
||||
```bash
|
||||
#!/bin/bash
|
||||
if [ -f ~/.vim_theme ] && [ "$(cat ~/.vim_theme)" = "light" ]; then
|
||||
tmux set -g @catppuccin_flavor "latte"
|
||||
else
|
||||
tmux set -g @catppuccin_flavor "mocha"
|
||||
fi
|
||||
```
|
||||
|
||||
2. **Add to tmux config** (`~/.config/tmux/tmux.conf`):
|
||||
```bash
|
||||
# Dynamic theme switching based on ~/.vim_theme file
|
||||
run 'bash ~/.config/tmux/themeswitch.sh'
|
||||
```
|
||||
|
||||
3. **Add to shell config** (`~/.zshrc`):
|
||||
```bash
|
||||
# Export THEME environment variable for nvim and other apps
|
||||
if [ -f ~/.vim_theme ]; then
|
||||
export THEME=$(cat ~/.vim_theme)
|
||||
else
|
||||
export THEME="dark" # default
|
||||
fi
|
||||
```
|
||||
|
||||
### Usage:
|
||||
```bash
|
||||
# Switch to light theme
|
||||
echo "light" > ~/.vim_theme
|
||||
|
||||
# Switch to dark theme
|
||||
echo "dark" > ~/.vim_theme
|
||||
```
|
||||
|
||||
### Benefits:
|
||||
- ✅ **Single source of truth:** `~/.vim_theme` file controls all applications
|
||||
- ✅ **Automatic propagation:** New terminals inherit theme via shell config
|
||||
- ✅ **No environment variable issues:** File-based approach avoids tmux env var propagation problems
|
||||
- ✅ **Cross-application support:** nvim reads `$THEME`, tmux uses catppuccin flavors
|
||||
|
||||
### Limitations:
|
||||
- **Tmux live reload:** Changes require tmux config reload or session restart
|
||||
- **Workaround:** Use tmux-resurrect to quickly restore sessions after restart
|
||||
|
||||
## Legacy: Tmux and terminal not updating after theme switch
|
||||
|
||||
**Issue:** After running the theme switcher script, tmux sessions and existing terminals don't reflect the new theme until restarted.
|
||||
|
||||
**Temporary workaround:**
|
||||
- Restart tmux sessions: `tmux kill-server && tmux`
|
||||
- Open new terminal windows
|
||||
|
||||
**Status:** ✅ **Solved** - Use file-based theme management system above
|
||||
|
||||
## Tmux window names showing hostname instead of command
|
||||
|
||||
**Issue:** Tmux windows show "homelab" (hostname) for inactive tabs but correct command names for active tabs.
|
||||
|
||||
**Root cause:** Catppuccin tmux theme with `@catppuccin_window_tabs_enabled on` uses different text formatting for active vs inactive windows.
|
||||
|
||||
**Solution:** Disable catppuccin window tabs:
|
||||
```
|
||||
set -g @catppuccin_window_tabs_enabled off
|
||||
```
|
||||
|
||||
**Alternative:** Configure explicit window text for both states:
|
||||
```
|
||||
set -g @catppuccin_window_default_text "#W"
|
||||
set -g @catppuccin_window_current_text "#W"
|
||||
```
|
||||
|
||||
Also ensure automatic renaming is enabled:
|
||||
```
|
||||
setw -g automatic-rename on
|
||||
setw -g allow-rename on
|
||||
```
|
||||
|
||||
# Font and Unicode Display Issues
|
||||
|
||||
## Missing emoji and unicode symbols
|
||||
|
||||
**Issue:** Emojis show as boxes or missing characters, unicode symbols don't display properly.
|
||||
|
||||
**Solution:** Install comprehensive unicode font packages:
|
||||
```bash
|
||||
sudo pacman -S noto-fonts-emoji noto-fonts-extra
|
||||
fc-cache -f
|
||||
```
|
||||
|
||||
## Nerd Font icons not displaying
|
||||
|
||||
**Issue:** Developer icons (programming languages, git symbols, file types) show as blank spaces or boxes.
|
||||
|
||||
**Root cause:** Terminal emulator not configured to use Nerd Font as primary font.
|
||||
|
||||
**Solution:**
|
||||
1. Install Nerd Fonts:
|
||||
```bash
|
||||
sudo pacman -S ttf-iosevkaterm-nerd ttf-jetbrains-mono-nerd
|
||||
fc-cache -f
|
||||
```
|
||||
|
||||
2. Configure terminal to use Nerd Font as primary font
|
||||
3. For wezterm, ensure config includes:
|
||||
```lua
|
||||
config.font = wezterm.font_with_fallback {
|
||||
'IosevkaTerm Nerd Font',
|
||||
'JetBrainsMono Nerd Font Mono',
|
||||
'Noto Color Emoji'
|
||||
}
|
||||
```
|
||||
|
||||
**Testing:** Use printf with direct codepoints:
|
||||
```bash
|
||||
printf "Icons: \\ue702 \\uf121 \\uf015 \\uf07b\\n"
|
||||
```
|
||||
|
||||
## Ancient/exotic script support
|
||||
|
||||
**Comprehensive coverage achieved with:**
|
||||
- `noto-fonts` (base unicode)
|
||||
- `noto-fonts-cjk` (Chinese/Japanese/Korean)
|
||||
- `noto-fonts-emoji` (color emoji)
|
||||
- `noto-fonts-extra` (additional scripts)
|
||||
|
||||
Successfully displays: Egyptian hieroglyphs, Cuneiform, Nordic runes, Hungarian rovás, Arabic, Chinese, Japanese, Korean, Thai, Hindi, Hebrew, Greek, Tamil.
|
||||
|
||||
# Cannot tile windows by drag and dropping
|
||||
|
||||
Keyboard workaround: Go to Settings > Window Manager > Keyboard, set up tiling shortcuts (set to Super+arrow keys)
|
||||
|
||||
# Additional Known Issues (TODO Items)
|
||||
|
||||
## Tmux battery indicator missing until config reload
|
||||
|
||||
**Issue:** Battery indicator doesn't appear in tmux status line immediately after starting tmux.
|
||||
|
||||
**Temporary workaround:** Reload tmux config with `Prefix + r` or restart tmux session.
|
||||
|
||||
**Status:** Investigation needed
|
||||
|
||||
## TTY fallbacks needed
|
||||
|
||||
**Issue:** When not in X11/graphical mode, nvim and tmux need proper fallback configurations.
|
||||
|
||||
**Status:** Completed
|
||||
|
||||
**Solutions implemented:**
|
||||
- ✅ **nvim:** TTY detection and color scheme fallback configured
|
||||
- ✅ **Font:** Selected ter-124b (12x24 bold) for good readability
|
||||
- ✅ **Keyboard:** Colemak layout with caps lock remapped to backspace
|
||||
- ✅ **Caps lock fix:** Uses systemd service with `setkeycodes 3a 14`
|
||||
|
||||
**Configuration files:**
|
||||
- `/etc/systemd/system/caps-backspace.service` - Permanent caps lock remapping
|
||||
- TTY font testing script: `~/.local/scripts/test-fonts.sh`
|
||||
|
||||
## TTY Caps Lock Not Working as Backspace
|
||||
|
||||
**Issue:** With colemak keymap loaded, caps lock acts like Control instead of backspace in TTY.
|
||||
|
||||
**Root cause:** Colemak keymap maps caps lock to Control, which conflicts with tmux navigation keys.
|
||||
|
||||
**Solution:** Use `setkeycodes` to remap at scancode level:
|
||||
```bash
|
||||
sudo setkeycodes 3a 14 # Map caps lock scancode to backspace keycode
|
||||
```
|
||||
|
||||
**Permanent fix:** Systemd service created at `/etc/systemd/system/caps-backspace.service`
|
||||
|
||||
## Laptop sleeps when lid is closed
|
||||
|
||||
Solution:
|
||||
|
||||
sudo nvim /etc/systemd/logind.conf
|
||||
|
||||
Uncomment and change these lines:
|
||||
|
||||
```
|
||||
HandleLidSwitch=ignore
|
||||
HandleLidSwitchExternalPower=ignore
|
||||
HandleLidSwitchDocked=ignore
|
||||
```
|
||||
|
||||
Then restart service:
|
||||
`sudo systemctl restart systemd-logind`
|
||||
|
||||
## IP addresses keep changing
|
||||
|
||||
Due to 3 interfaces:
|
||||
* Wifi
|
||||
* Ethernet left port (ThinkPad adapter) - Wired Connection 1
|
||||
* Ethernet right port (regular ethernet cable) - Wired Connection 2
|
||||
|
||||
### Proposed solution
|
||||
|
||||
* Stick with wired2
|
||||
|
||||
● Configure static IP for "Wired connection 2" (enp4s0):
|
||||
|
||||
* Set static IP to 192.168.0.100
|
||||
sudo nmcli connection modify "Wired connection 2" \
|
||||
ipv4.method manual \
|
||||
ipv4.addresses 192.168.0.100/24 \
|
||||
ipv4.gateway 192.168.0.1 \
|
||||
ipv4.dns 192.168.0.1
|
||||
|
||||
* Apply the changes
|
||||
sudo nmcli connection up "Wired connection 2"
|
||||
|
||||
Then configure WiFi with the same static IP:
|
||||
|
||||
* First connect to your WiFi if not already
|
||||
sudo nmcli connection up "Telekom-4b28df-2.4GHz"
|
||||
|
||||
* Set same static IP for WiFi
|
||||
sudo nmcli connection modify "Telekom-4b28df-2.4GHz" \
|
||||
ipv4.method manual \
|
||||
ipv4.addresses 192.168.0.100/24 \
|
||||
ipv4.gateway 192.168.0.1 \
|
||||
ipv4.dns 192.168.0.1
|
||||
|
||||
Verify the configuration:
|
||||
nmcli connection show "Wired connection 2" | grep ipv4
|
||||
ip addr show enp4s0
|
||||
|
||||
This way both your ethernet (enp4s0) and WiFi will use 192.168.0.100, solving your dual interface IP issue.
|
||||
Ready to run these commands?
|
||||
Reference in New Issue
Block a user