Workstation Template

Marchyo includes a workstation template that provides a complete developer setup with desktop environment, development tools, and sensible defaults.

Getting started

1. Initialize the template

nix flake init -t github:Jylhis/marchyo#workstation

2. Generate hardware configuration

nixos-generate-config --show-hardware-config > hardware-configuration.nix

3. Customize configuration.nix

Edit the generated configuration:

• Change networking.hostName to your workstation name
• Update marchyo.users.developer with your details
• Set marchyo.timezone / marchyo.defaultLocale if the defaults (Europe/Zurich, en_US.UTF-8) don’t fit
• Development tooling is a single switch — set marchyo.development.enable = false if you don’t want it

4. Test in a VM (optional)

nixos-rebuild build-vm --flake .#workstation
./result/bin/run-workstation-vm

5. Build and switch

sudo nixos-rebuild switch --flake .#workstation

What’s included

Desktop environment

• Hyprland (Wayland compositor) with all Marchyo customizations
• Ghostty terminal

Development tools

• Editors — jotain (Jylhis’s Emacs config) by default; switch via marchyo.defaults.editor (emacs, vscode, vscodium, zed) and marchyo.defaults.terminalEditor (emacs, neovim, helix, nano)
• Version control — Git with Git LFS, GitHub CLI
• Containers — Docker with docker-compose, buildah, skopeo, lazydocker
• Virtualization — QEMU/KVM via libvirtd
• Build & debug — gnumake, cmake, gcc, jq/yq, nmap, tcpdump

Terminal enhancements

• Starship prompt
• Zoxide (smart cd)
• fzf (fuzzy finder)
• ripgrep (fast grep)
• fd (fast find)

Customization tips

Adding programming languages

environment.systemPackages = with pkgs; [
  python3
  nodejs
  rustc cargo
  go
  jdk17
];

VS Code extensions

programs.vscode = {
  enable = true;
  extensions = with pkgs.vscode-extensions; [
    ms-python.python
    rust-lang.rust-analyzer
  ];
};

Using Podman instead of Docker

virtualisation.podman = {
  enable = true;
  dockerCompat = true;
  defaultNetwork.settings.dns_enabled = true;
};

Project-specific dev shells with direnv

programs.direnv = {
  enable = true;
  nix-direnv.enable = true;
};

Then in your project directory, create a .envrc:

use flake

Multi-monitor setup

Override Hyprland monitor configuration in your home config:

wayland.windowManager.hyprland.settings = {
  monitor = [
    "DP-1,1920x1080@60,0x0,1"
    "HDMI-A-1,1920x1080@60,1920x0,1"
  ];
};

Updating

nix flake update
sudo nixos-rebuild switch --flake .#workstation