CachyOS Deployment Guide

CachyOS Deployment Guide & Företagsstandard

Denna guide täcker komplett installation, utvecklingsmiljö, strömmad Google Drive med anpassade högerklicksmenyer i KDE Plasma 6 samt versionshantering av inställningar via Chezmoi.

---

1. Installationen (CachyOS Installer)

När datorn startas från USB-minnet, välj följande i installationsprogrammet:

• Desktop Environment (Skrivbord): Välj KDE Plasma.
• Bootloader: Välj Limine.
• Slutför installationen, starta om datorn och logga in.

---

2. Installera grundpaket (paru och flatpak)

Öppna terminalen (Fish) och kör:

# 1. Uppdatera systemets arkiv och installera paru, flatpak samt urklippsverktyg
sudo pacman -Syu paru flatpak wl-clipboard --noconfirm

# 2. Lägg till Flathub-arkivet för dina Flatpaks
flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo

---

3. Installera mjukvarustacken

Kör dessa kommandon för att installera alla verktyg, appar och Chezmoi:

# 1. Installera utvecklarverktyg, databasverktyg, chezmoi, webbläsare, Tailscale och rclone via paru
paru -Syu podman code git dbeaver nodejs npm go chezmoi tailscale libreoffice-fresh google-chrome obs-studio rclone --noconfirm

# 2. Installera kommunikationsapparna via Flatpak
flatpak install flathub us.zoom.Zoom com.github.IsmaelMartinez.teams_for_linux -y

---

4. Konfigurera utvecklingsmiljön & tjänster (Fish, Podman, Tailscale, Node & Go)

Vi aktiverar systemtjänsterna och sätter upp miljövariabler i Fish:

# 1. Starta Podmans socket för ditt användarkonto
systemctl --user enable --now podman.socket

# 2. Aktivera och starta Tailscale-tjänsten i systemet
sudo systemctl enable --now tailscaled

# 3. Logga in på Tailscale-kontot (klicka på länken som visas i terminalen)
sudo tailscale up

# 4. Konfigurera npm så att globala paket installeras i din hemkatalog
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'

# 5. Lägg till Podman-socket, globala npm-binärer och Go-binärer i Fish PATH
echo 'set -gx DOCKER_HOST unix:///run/user/(id -u)/podman/podman.sock' >> ~/.config/fish/config.fish
echo 'fish_add_path ~/.npm-global/bin' >> ~/.config/fish/config.fish
echo 'fish_add_path (go env GOPATH)/bin' >> ~/.config/fish/config.fish

# 6. Ladda om konfigurationen
source ~/.config/fish/config.fish

Konfigurera VS Code för Podman:

1. Öppna VS Code -> Gå till Inställningar (Ctrl + ,).
2. Sök efter Dev: Docker Path och ändra värdet till: podman
3. Sök efter Dev: Docker Host och ändra värdet till: unix:///run/user/1000/podman/podman.sock

---

5. Konfigurera strömmad Google Drive & Autostart

1. Kör igång konfigurationen:

   rclone config

2. Följ guiden i terminalen:

   • Skriv n (New remote) -> Enter.
   • Döp den till gdrive -> Enter.
   • Skriv drive -> Enter.
   • Lämna client_id och client_secret tomma -> Enter.
   • Vid scope, välj 1 (Full access) -> Enter.
   • Lämna service_account_file tomt -> Enter.
   • Vid Edit advanced config, skriv n -> Enter.
   • Vid Use web browser to automatically authenticate, skriv y -> Enter.
   • Logga in på Google-kontot i webbläsaren, välj “Tillåt” och stäng fliken.
   • Vid Configure this as a Shared Drive?, skriv n -> Enter.
   • Godkänn med y och avsluta med q.

3. Skapa autostartskriptet:

   # Skapa mappen där Google Drive ska visas i Dolphin
   mkdir -p ~/GoogleDrive
   
   # Skapa skriptet i din hemkatalog
   echo '#!/bin/bash' > ~/mount_gdrive.sh
   echo 'rclone mount gdrive: ~/GoogleDrive --vfs-cache-mode writes --drive-shared-with-me' >> ~/mount_gdrive.sh
   chmod +x ~/mount_gdrive.sh

4. Aktivera skriptet i systemet:

   • Öppna Systeminställningar -> Autostart.
   • Klicka på Lägg till… -> Välj Inloggningsskript (Login Script).
   • Välj filen mount_gdrive.sh i din hemkatalog.

---

6. Installera Google Drive Högerklicksmeny i Dolphin

Kör detta block för att skapa hjälpskriptet och koppla det till högerklicksmenyn i Dolphin:

# 1. Skapa mapparna som behövs
mkdir -p ~/.local/bin
mkdir -p ~/.local/share/kio/servicemenus

# 2. Skapa hjälpskriptet för delning och webblänkar
echo '#!/bin/bash
MODE="$1"
FILE_PATH="$2"

RELATIVE_PATH=$(echo "$FILE_PATH" | sed "s|$HOME/GoogleDrive/||")
LINK=$(rclone link "gdrive:$RELATIVE_PATH" 2>/dev/null)

if [ -n "$LINK" ]; then
    if [ "$MODE" = "--copy" ]; then
        echo -n "$LINK" | wl-copy
        notify-send "Google Drive" "Delningslänk kopierad till urklipp!\n$LINK" -i google-chrome
    elif [ "$MODE" = "--open" ]; then
        xdg-open "$LINK"
    fi
else
    notify-send "Google Drive" "Kunde inte generera länk för denna fil." -i dialog-error
fi' > ~/.local/bin/gdrive-share.sh

# 3. Skapa .desktop-filen för Dolphin (Plasma 6)
echo '[Desktop Entry]
Type=Service
ServiceTypes=KonqPopupMenu/Plugin
MimeType=all/all;
Actions=CopyGDriveLink;OpenInBrowser;
X-KDE-Submenu=Google Drive

[Desktop Action CopyGDriveLink]
Name=Kopiera delningslänk (Google Share URL)
Icon=edit-copy
Exec=/home/'$USER'/.local/bin/gdrive-share.sh --copy %f

[Desktop Action OpenInBrowser]
Name=Öppna på webben (Google Drive)
Icon=internet-web-browser
Exec=/home/'$USER'/.local/bin/gdrive-share.sh --open %f' > ~/.local/share/kio/servicemenus/gdrive_share.desktop

# 4. Sätt rätt behörigheter (+x på båda krävs i Plasma 6)
chmod +x ~/.local/bin/gdrive-share.sh
chmod +x ~/.local/share/kio/servicemenus/gdrive_share.desktop

# 5. Bygg om KDE-cachen
kbuildsycoca6 --noincremental

---

7. Systemjusteringar (Skärm, Skrollning, Genvägar & Windows-look)

• Fixa storleken på skärmen (Fonts & ikoner): Gå till Systeminställningar -> Skärm och skärmhantering -> Skärmkonfiguration. Ändra Global skalning till 125% eller 150%. Klicka på Verkställ. (Logga ut och in igen efteråt).
• Fixa skrollriktningen: Gå till Systeminställningar -> Inmatningsenheter -> Pekplatta. Bocka UR rutan för Invertera skrollriktning (Naturlig skrollning). Klicka på Verkställ.
• Fixa Ctrl + Esc för Startmenyn: Högerklicka på startmeny-ikonen längst ner till vänster -> välj Konfigurera programstartare… -> Klicka på Genvägar -> Klicka på genvägsknappen och tryck Ctrl + Esc. Välj att reassigna den från systemövervakaren. Klicka på Verkställ.
• Fixa det snygga “Windows-utseendet”:
  1. Gå till Systeminställningar -> Utseende -> Globalt tema.
  2. Klicka på Hämta nya globala teman… nere till höger.
  3. Sök efter Breeze-Blur eller We10X. Installera och applicera.
  4. Gå till underkategorin Ikoner -> Klicka på Hämta nya ikoner… -> Sök efter We10X Icon Theme eller Papirus. Installera och applicera.
  5. (Valfritt för Win 11-stil) Om du vill att dina öppna program ska ligga centrerade i bottenfältet: Högerklicka på fältet -> välj Redigera panel. Klicka på Lägg till avståndshållare (Add Spacer) och dra den så att den ligger till vänster om appikonerna.

---

8. Automatisera inställningar med Chezmoi (Dotfiles)

För att spara alla inställningar och snabbt rulla ut dem på nya maskiner för anställda:

Initiera och spara inställningar (Sätts upp en gång av admin)

# 1. Initiera Chezmoi
chezmoi init

# 2. Lägg till alla viktiga konfigurationsfiler och skript
chezmoi add ~/.config/fish/config.fish
chezmoi add ~/.local/bin/gdrive-share.sh
chezmoi add ~/.local/share/kio/servicemenus/gdrive_share.desktop
chezmoi add ~/mount_gdrive.sh
chezmoi add ~/.config/kdeglobals
chezmoi add ~/.config/dolphinrc
chezmoi add ~/.config/kcminputrc

# 3. Pusha till ert GitHub/GitLab-repo
chezmoi cd
git remote add origin https://github.com/Systementor-AB/cachyosdotfiles.git
git branch -M main
git add .
git commit -m "Initial setup for company CachyOS"
git push -u origin main
exit

Rulla ut på en ny anställds dator

Kör detta enkla kommando på en nyinstallerad dator för att applicera alla inställningar, skript och genvägar direkt:

chezmoi init --apply https://github.com/DITT_ANVÄNDARNAMN/dotfiles.git