Complete setup for Lenovo LOQ 17IRX10 (i7-13700HX + RTX 5060 Laptop 8GB) on Arch Linux.
| Method | Description | Time |
|---|---|---|
| Modular Scripts | Step-by-step installation | 30-45 min |
| Arch from Zero | Full Arch installation guide | 2-3 hours |
- ✅ NVIDIA Blackwell - RTX 5060 Laptop 8GB (sm_120)
- ✅ Intel i7-13700HX - P/E cores, HWP, undervolt
- ✅ Lenovo WMI - Power modes, fan control, charging
- ✅ KDE Plasma 6 - Wayland optimized
| Document | Description |
|---|---|
| Installation Guide | Arch from Zero + modular scripts |
| Power Management | TLP, legion_linux, loq-mode |
| CPU Tuning | Intel undervolt, pstate diagnostics |
| GPU Setup | NVIDIA Blackwell, envycontrol |
| Fan Control | legiond, custom curves |
| LLM Stack | Ollama, llama.cpp, Open WebUI |
| Secrets Management | git-crypt, SOPS, GitHub Secrets |
git clone https://github.com/ciroautuori/archloq.git
cd archloq
# 1. Review the config first — these scripts run as root
$EDITOR config/loq.conf
# 2. Run the modular installer
sudo ./install-scripts/pacmaster.shRead before running. Every script here modifies system-level settings (kernel modules, power, undervolt, fan curves) and is tuned for the exact hardware listed above. Review anything you run as root, and make sure you have a way back — see docs/INSTALLATION.md.
Optional — fetch the upstream reference repos (llama.cpp, ollama, open-webui):
./runtime/fetch-runtime.shEdit config/loq.conf before installation:
LOQ_HOSTNAME="loq"
LOQ_USERNAME="yourname"
LOQ_TIMEZONE="Europe/Rome"
# Enable features
LOQ_ENABLE_OLLAMA="1"
LOQ_ENABLE_UNDERVOLT="1"
LOQ_ENABLE_LLAMA_CPP="1"
# GPU mode
LOQ_GPU_MODE="hybrid" # hybrid, intel, nvidiaarchloq/
├── README.md
├── LICENSE
├── CONTRIBUTING.md
├── SECURITY.md
├── .github/
│ ├── workflows/ci.yml # shellcheck, syntax, exec bits, secret scan
│ ├── ISSUE_TEMPLATE/
│ └── pull_request_template.md
├── docs/
│ ├── INSTALLATION.md
│ ├── POWER_MANAGEMENT.md
│ ├── CPU_TUNING.md
│ ├── GPU_SETUP.md
│ ├── FAN_CONTROL.md
│ ├── LLM_STACK.md
│ └── SECRETS.md
├── config/
│ ├── loq.conf # main configuration
│ ├── tlp.d/
│ ├── modprobe.d/
│ ├── legion_linux/
│ └── applications/
├── scripts/ # loq-mode, loq-power-apply, loq-power-diag, ...
├── install-scripts/
│ ├── pacmaster.sh # entrypoint
│ ├── lib/utils.sh
│ └── app/01_*.sh ... 99_*.sh
├── optimize/ # sysctl, journald, udev, Wayland env
├── manage/loq-backup.sh
├── dotfiles/ # Catppuccin/OneDark, zsh, nvim, konsole, ...
└── runtime/ # upstream reference clones (NOT tracked)
├── README.md
└── fetch-runtime.sh # clone/update them on demand
Use docs/SECRETS.md for:
- git-crypt setup
- SOPS configuration
- GitHub Actions Secrets
- Template files
See CONTRIBUTING.md. Security issues: please follow SECURITY.md rather than opening a public issue.
MIT — see LICENSE.