[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"$fRQJSa0ic-cFoRr9HXkE1kNF9i0m3XyljMcuj-TAvbnE":3},{"id":4,"title":5,"teaser":6,"body":7,"slug":8,"date":9,"coverImage":10,"tags":15},"f353d484-15a4-441a-b7d9-5c2166261943","Getting Omarchy Running: What I Actually Did","","\u003Cp>Look, I just installed Omarchy on my laptop. Fresh. And yeah, it's amazing out of the box, but let's be honest - you're going to want your own tools. This isn't a generic tutorial. This is what I actually did to get from \"nice Linux desktop\" to \"ready to work.\"\u003C\u002Fp>\u003Ch2>What is Omarchy, really?\u003C\u002Fh2>\u003Cp>DHH made it. The Ruby on Rails guy. He got fed up with Apple's App Store nonsense and decided to build his own Linux distribution. Not just scripts - a full operating system that looks nothing like the desktop environments you're used to.\u003C\u002Fp>\u003Cp>Everything happens via keyboard. I mean EVERYTHING. Your mouse basically retires. Sounds weird? It is at first. But then you realize you're flying through tasks.\u003C\u002Fp>\u003Cp>37signals (DHH's company) is moving their entire dev team to this. Over three years, they're ditching Macs completely. Why? Rails tests run twice as fast on Linux. Docker works natively. No virtualization overhead.\u003C\u002Fp>\u003Cp>The shortcuts you need to remember RIGHT NOW:\u003C\u002Fp>\u003Cul>\u003Cli>\u003Ccode>Super + Space\u003C\u002Fcode> - Launch anything\u003C\u002Fli>\u003Cli>\u003Ccode>Super + Alt + Space\u003C\u002Fcode> - The Omarchy Menu (your control panel)\u003C\u002Fli>\u003Cli>\u003Ccode>Super + Return\u003C\u002Fcode> - Terminal\u003C\u002Fli>\u003Cli>\u003Ccode>Super + Esc\u003C\u002Fcode> - Reload everything\u003C\u002Fli>\u003C\u002Ful>\u003Cp>Got it? Good. Let's actually install stuff.\u003C\u002Fp>\u003Ch2>Installing Essential Development Tools\u003C\u002Fh2>\u003Ch3>Setting Up Zsh and Oh My Zsh\u003C\u002Fh3>\u003Cp>Omarchy doesn't come with zsh by default, but it's easy to install and configure:\u003C\u002Fp>\u003Cpre>\u003Ccode class=\"language-plaintext language-bash\"># Install zsh\nsudo pacman -S zsh\n\n# Add zsh to valid shells\ncommand -v zsh | sudo tee -a \u002Fetc\u002Fshells\n\n# Install Oh My Zsh\nsh -c \"$(curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fohmyzsh\u002Fohmyzsh\u002Fmaster\u002Ftools\u002Finstall.sh)\"\n\n# Set zsh as default shell (if chsh doesn't work, use the workaround below)\nsudo usermod -s \u002Fusr\u002Fbin\u002Fzsh $USER\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>\u003Cstrong>If shell changing doesn't work\u003C\u002Fstrong>, add this to your \u003Ccode>~\u002F.bashrc\u003C\u002Fcode> as a workaround:\u003C\u002Fp>\u003Cpre>\u003Ccode class=\"language-plaintext language-bash\">echo 'exec zsh' >> ~\u002F.bashrc\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Ch3>Installing Oh My Zsh Plugins\u003C\u002Fh3>\u003Cp>Enhance your terminal experience with these essential plugins:\u003C\u002Fp>\u003Cpre>\u003Ccode class=\"language-plaintext language-bash\"># Autosuggestions (suggests commands as you type)\ngit clone https:\u002F\u002Fgithub.com\u002Fzsh-users\u002Fzsh-autosuggestions ${ZSH_CUSTOM:-~\u002F.oh-my-zsh\u002Fcustom}\u002Fplugins\u002Fzsh-autosuggestions\n\n# Syntax highlighting (colors your commands)\ngit clone https:\u002F\u002Fgithub.com\u002Fzsh-users\u002Fzsh-syntax-highlighting.git ${ZSH_CUSTOM:-~\u002F.oh-my-zsh\u002Fcustom}\u002Fplugins\u002Fzsh-syntax-highlighting\n\n# Enable plugins - quick one-liner method\nsed -i 's\u002Fplugins=(git)\u002Fplugins=(git zsh-autosuggestions zsh-syntax-highlighting sudo colored-man-pages command-not-found)\u002F' ~\u002F.zshrc\n\n# Reload configuration\nsource ~\u002F.zshrc\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>\u003Cstrong>Plugin features:\u003C\u002Fstrong>\u003C\u002Fp>\u003Cul>\u003Cli>\u003Cstrong>zsh-autosuggestions\u003C\u002Fstrong> - Press → to accept suggestions\u003C\u002Fli>\u003Cli>\u003Cstrong>zsh-syntax-highlighting\u003C\u002Fstrong> - Red = invalid command, green = valid\u003C\u002Fli>\u003Cli>\u003Cstrong>sudo\u003C\u002Fstrong> - Double-tap ESC to add sudo to previous command\u003C\u002Fli>\u003Cli>\u003Cstrong>colored-man-pages\u003C\u002Fstrong> - Colorful, readable man pages\u003C\u002Fli>\u003C\u002Ful>\u003Ch3>Installing IDEs and Editors\u003C\u002Fh3>\u003Ch4>VSCode\u003C\u002Fh4>\u003Cpre>\u003Ccode class=\"language-plaintext language-bash\">yay -S visual-studio-code-bin\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>Or use the Omarchy Menu: \u003Ccode>Super + Alt + Space\u003C\u002Fcode> → Install → Editor → VSCode\u003C\u002Fp>\u003Ch4>Setting Default Editor\u003C\u002Fh4>\u003Cp>After installing your preferred editor, set it as default:\u003C\u002Fp>\u003Col>\u003Cli>Press \u003Ccode>Super + Alt + Space\u003C\u002Fcode>\u003C\u002Fli>\u003Cli>Navigate to Setup → Defaults\u003C\u002Fli>\u003Cli>Edit the UWSM defaults file\u003C\u002Fli>\u003Cli>Save and press \u003Ccode>Super + Esc\u003C\u002Fcode> to reload\u003C\u002Fli>\u003C\u002Fol>\u003Ch3>Installing Development Tools\u003C\u002Fh3>\u003Cpre>\u003Ccode class=\"language-plaintext language-bash\"># Install ddev (Docker-based development environment)\nyay -S ddev-bin\n\n# Install all at once if you prefer\nyay -S visual-studio-code-bin ddev-bin slack-desktop discord\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Ch3>Installing Claude Code\u003C\u002Fh3>\u003Cp>Claude Code is an AI-powered coding assistant that works directly in your terminal:\u003C\u002Fp>\u003Cpre>\u003Ccode class=\"language-plaintext language-bash\"># Recommended: Native installer\ncurl -fsSL https:\u002F\u002Fclaude.ai\u002Finstall.sh | bash\n\n# Alternative: via npm\nnpm install -g @anthropic-ai\u002Fclaude-code\n\n# Verify installation\nclaude doctor\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>\u003Cstrong>First-time setup:\u003C\u002Fstrong>\u003C\u002Fp>\u003Cpre>\u003Ccode class=\"language-plaintext language-bash\">cd ~\u002Fyour-project\nclaude\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>On first run, you'll authenticate through your browser using either Claude Max or Anthropic Console.\u003C\u002Fp>\u003Cp>\u003Cstrong>Note:\u003C\u002Fstrong> Claude Code requires either a Claude Max subscription or API credits. Max is usually more economical for regular use.\u003C\u002Fp>\u003Ch2>Managing Installed Applications\u003C\u002Fh2>\u003Ch3>Finding Installed Packages\u003C\u002Fh3>\u003Cpre>\u003Ccode class=\"language-plaintext language-bash\"># Search for specific packages\npacman -Q | grep -i \"search-term\"\n\n# List all installed packages\npacman -Q\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Ch3>Removing Unwanted Applications\u003C\u002Fh3>\u003Cpre>\u003Ccode class=\"language-plaintext language-bash\"># Remove package and unused dependencies\nsudo pacman -Rs package-name\n\n# Example: Remove specific apps\nsudo pacman -Rs 1password-beta 1password-cli\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Ch3>Using the Omarchy Menu\u003C\u002Fh3>\u003Cp>The easiest way to manage apps:\u003C\u002Fp>\u003Col>\u003Cli>Press \u003Ccode>Super + Alt + Space\u003C\u002Fcode>\u003C\u002Fli>\u003Cli>Navigate to Remove\u003C\u002Fli>\u003Cli>Browse and select apps to uninstall\u003C\u002Fli>\u003C\u002Fol>\u003Ch2>Configuring Multiple Keyboard Layouts\u003C\u002Fh2>\u003Cp>If you work in multiple languages, you'll want to switch between keyboard layouts easily:\u003C\u002Fp>\u003Cp>\u003Cstrong>Edit Hyprland configuration:\u003C\u002Fstrong>\u003C\u002Fp>\u003Cpre>\u003Ccode class=\"language-plaintext language-bash\">vim ~\u002F.config\u002Fhypr\u002Fhyprland.conf\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>\u003Cstrong>Add\u002Fmodify the input section:\u003C\u002Fstrong>\u003C\u002Fp>\u003Cpre>\u003Ccode class=\"language-plaintext\">input {\n    kb_layout = us,dk\n    kb_variant = \n    kb_model =\n    kb_options = grp:alt_shift_toggle\n    # ... other input settings\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>\u003Cstrong>Switch layouts:\u003C\u002Fstrong> Press \u003Ccode>Alt + Shift\u003C\u002Fcode>\u003C\u002Fp>\u003Cp>\u003Cstrong>Alternative switching options:\u003C\u002Fstrong>\u003C\u002Fp>\u003Cul>\u003Cli>\u003Ccode>grp:win_space_toggle\u003C\u002Fcode> - Super + Space\u003C\u002Fli>\u003Cli>\u003Ccode>grp:caps_toggle\u003C\u002Fcode> - CapsLock toggles\u003C\u002Fli>\u003Cli>\u003Ccode>grp:ctrl_shift_toggle\u003C\u002Fcode> - Ctrl + Shift\u003C\u002Fli>\u003C\u002Ful>\u003Cp>\u003Cstrong>Apply changes:\u003C\u002Fstrong> Press \u003Ccode>Super + Esc\u003C\u002Fcode> to reload Hyprland\u003C\u002Fp>\u003Ch2>Package Management Tips\u003C\u002Fh2>\u003Cp>Omarchy uses a combination of package managers:\u003C\u002Fp>\u003Ch3>pacman (Official Arch packages)\u003C\u002Fh3>\u003Cpre>\u003Ccode class=\"language-plaintext language-bash\"># Update system\nsudo pacman -Syu\n\n# Install package\nsudo pacman -S package-name\n\n# Remove package\nsudo pacman -R package-name\n\n# Remove with dependencies\nsudo pacman -Rs package-name\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Ch3>yay (AUR helper)\u003C\u002Fh3>\u003Cpre>\u003Ccode class=\"language-plaintext language-bash\"># Search AUR\nyay -Ss search-term\n\n# Install from AUR\nyay -S package-name\n\n# Update AUR packages\nyay -Syu\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Ch3>Omarchy Menu\u003C\u002Fh3>\u003Cp>The GUI way: \u003Ccode>Super + Alt + Space\u003C\u002Fcode> gives you access to:\u003C\u002Fp>\u003Cul>\u003Cli>\u003Cstrong>Install\u003C\u002Fstrong> → Package (Arch repos)\u003C\u002Fli>\u003Cli>\u003Cstrong>Install\u003C\u002Fstrong> → AUR (AUR packages)\u003C\u002Fli>\u003Cli>\u003Cstrong>Install\u003C\u002Fstrong> → Editor, Style, Font (curated lists)\u003C\u002Fli>\u003Cli>\u003Cstrong>Remove\u003C\u002Fstrong> → Uninstall applications\u003C\u002Fli>\u003Cli>\u003Cstrong>Update\u003C\u002Fstrong> → System updates\u003C\u002Fli>\u003C\u002Ful>\u003Ch2>Troubleshooting Common Issues\u003C\u002Fh2>\u003Ch3>Permission Errors with npm\u003C\u002Fh3>\u003Cp>Never use \u003Ccode>sudo npm install -g\u003C\u002Fcode>. Instead, configure npm properly:\u003C\u002Fp>\u003Cpre>\u003Ccode class=\"language-plaintext language-bash\">mkdir ~\u002F.npm-global\nnpm config set prefix '~\u002F.npm-global'\necho 'export PATH=~\u002F.npm-global\u002Fbin:$PATH' >> ~\u002F.zshrc\nsource ~\u002F.zshrc\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Ch3>Shell Won't Change\u003C\u002Fh3>\u003Cp>If \u003Ccode>chsh\u003C\u002Fcode> doesn't work, use the workaround:\u003C\u002Fp>\u003Cpre>\u003Ccode class=\"language-plaintext language-bash\">echo 'exec zsh' >> ~\u002F.bashrc\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Ch3>Missing Text Editors\u003C\u002Fh3>\u003Cp>Omarchy ships with Neovim but not nano. Install if needed:\u003C\u002Fp>\u003Cpre>\u003Ccode class=\"language-plaintext language-bash\">sudo pacman -S nano\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Ch3>Bluetooth Keyboard at Boot\u003C\u002Fh3>\u003Cp>Full-disk encryption requires a wired keyboard (or 2.4GHz wireless) to enter the password at startup. Bluetooth keyboards won't work at this stage.\u003C\u002Fp>\u003Ch2>Essential Omarchy Workflows\u003C\u002Fh2>\u003Ch3>File Management\u003C\u002Fh3>\u003Cp>Omarchy includes a file manager accessible through the app launcher (\u003Ccode>Super + Space\u003C\u002Fcode>).\u003C\u002Fp>\u003Ch3>Screenshots\u003C\u002Fh3>\u003Cp>Use the built-in screenshot tools via hotkeys or the Omarchy Menu.\u003C\u002Fp>\u003Ch3>Installing Fonts\u003C\u002Fh3>\u003Cp>\u003Ccode>Super + Alt + Space\u003C\u002Fcode> → Install → Style → Font\u003C\u002Fp>\u003Ch3>Theming\u003C\u002Fh3>\u003Cp>Omarchy comes beautifully themed, but you can customize: \u003Ccode>Super + Alt + Space\u003C\u002Fcode> → Style\u003C\u002Fp>\u003Ch2>Keeping Your System Updated\u003C\u002Fh2>\u003Cpre>\u003Ccode class=\"language-plaintext language-bash\"># Update Omarchy-specific packages\nomarchy-update-git\n\n# Update all system packages\nsudo pacman -Syu\n\n# Update AUR packages\nyay -Syu\n\n# Or use the Omarchy Menu\n# Super + Alt + Space → Update\n\u003C\u002Fcode>\u003C\u002Fpre>\u003Ch2>Useful Resources\u003C\u002Fh2>\u003Cul>\u003Cli>\u003Cstrong>Official Documentation:\u003C\u002Fstrong> https:\u002F\u002Flearn.omacom.io\u002F\u003C\u002Fli>\u003Cli>\u003Cstrong>Omarchy Website:\u003C\u002Fstrong> https:\u002F\u002Fomarchy.org\u002F\u003C\u002Fli>\u003Cli>\u003Cstrong>Community Discord:\u003C\u002Fstrong> Join for installation help and troubleshooting\u003C\u002Fli>\u003Cli>\u003Cstrong>GitHub Repository:\u003C\u002Fstrong> https:\u002F\u002Fgithub.com\u002Fbasecamp\u002Fomarchy\u003C\u002Fli>\u003C\u002Ful>\u003Ch2>Conclusion\u003C\u002Fh2>\u003Cp>Omarchy provides an excellent foundation for a modern development environment. With the tools and configurations covered in this guide, you'll have a fully customized system tailored to your workflow. The keyboard-driven approach may take some getting used to, but once mastered, it significantly boosts productivity.\u003C\u002Fp>\u003Cp>Remember: everything in Omarchy is designed to be accessible via keyboard shortcuts. Learn the basics (\u003Ccode>Super + Space\u003C\u002Fcode>, \u003Ccode>Super + Alt + Space\u003C\u002Fcode>, \u003Ccode>Super + Return\u003C\u002Fcode>), and you'll quickly discover why so many developers are making the switch.\u003C\u002Fp>\u003Cp>Happy coding on Omarchy!\u003C\u002Fp>\u003Chr>\u003Cp>\u003Cem>Have questions or suggestions for this guide? Feel free to reach out or leave a comment below.\u003C\u002Fem>\u003C\u002Fp>","getting-omarchy-running-what-i-actually-did","2025-10-07T07:05:45+00:00",{"id":11,"url":12,"alt":5,"width":13,"height":14},"94c50eb4-e07d-4f9a-9296-07ebcdc678f1","\u002Fsites\u002Fdefault\u002Ffiles\u002F2025-10\u002F1000061738%281%29.jpg",1125,2000,[16,19,22,25,28],{"id":17,"name":18,"slug":18},"b9e7e7c2-917e-4693-b3d5-0db82a7d80ca","omarchy",{"id":20,"name":21,"slug":21},"7867e670-e264-4621-b4fc-cc0a8c4b15dd","operating system",{"id":23,"name":24,"slug":24},"ec7b1417-6d0a-4518-b726-4bd2a0764356","open source",{"id":26,"name":27,"slug":27},"98c95e6b-edb6-4a31-a5a7-83531bb0b35b","Linux",{"id":29,"name":30,"slug":30},"901060fc-ba5a-4f54-9ea5-3a5fbf19e565","the alternative"]