# How to install Shuriken on Mac, Windows and Linux > Install Shuriken from shuriken.sh on Mac, Windows or Linux. The Mac app is notarised by Apple; Windows may warn once, as its installer isn't signed yet. Source: https://shuriken.sh/guides/install-shuriken Install Shuriken from shuriken.sh on Mac, Windows or Linux. The Mac app is notarised by Apple; Windows may warn once, as its installer isn't signed yet. By Shuriken Updated 27 October 2026 3 min read **Contents** To install Shuriken, download it from [shuriken.sh/download](https://shuriken.sh/download) for a Mac with Apple silicon on macOS 13 or later, Windows 10 or 11, or Linux (AppImage or .deb), open it and sign in. On Windows the first open may ask once: choose More info › Run anyway. After that it updates itself. Windows asks because the installer isn't signed with a Windows code-signing certificate yet. The Mac app is signed with our Apple Developer ID and notarised by Apple. A server that runs your agents with no screen attached is added from the app, not downloaded. ## What you need # | System | Version | Chips | Files | | --- | --- | --- | --- | | macOS | 13 Ventura or later | Apple silicon (M1 or newer) | .dmg or .zip | | Windows | 10 or 11 | x64 | Installer (.exe) or .zip | | Linux | Desktop Linux, also ChromeOS's Linux | x64 and Arm | AppImage or .deb | | Server | Linux, Windows, or macOS on Apple silicon, no screen needed | | Added from the app | You also need the coding agents you want to run and your own sign-ins for them. Shuriken runs the agents on your computer with your plans and keys; it never bills model usage. ## Install on a Mac # - On [the download page](https://shuriken.sh/download), download Shuriken for Mac. It runs on Apple silicon (M1 or newer); Intel Macs aren't supported. - Open the .dmg and drag Shuriken to Applications. - Open Shuriken. If macOS asks whether to open an app downloaded from the internet, choose Open. - Sign in. The app is signed with our Apple Developer ID and notarised by Apple, so there's no Open Anyway step. Builds up to 5.0.0 weren't notarised; if you still have one, it updates itself to a notarised build. ## Install on Windows # - Download the installer (.exe) or the .zip. - Run it. If Windows SmartScreen says it protected your PC, choose More info › Run anyway. - Open Shuriken and sign in. SmartScreen warns because the app has no Windows code-signing certificate yet. What is signed are the updates: from version 5.0, Windows and Linux check each update against Shuriken's signature before installing it. Our post on [Shuriken on Windows](https://shuriken.sh/blog/shuriken-on-windows) covers the rest of the Windows setup. Shuriken adds a server of yours with one command, and its chats sit beside your computer's. [Download](https://shuriken.sh/download) ## Install on Linux # - Download the AppImage (any distribution) or the .deb (Debian, Ubuntu and their relatives), x64 or Arm. - For the AppImage: make it executable (chmod +x Shuriken*.AppImage) and run it. For the .deb: run sudo apt install ./ followed by the file's name. - Open Shuriken and sign in. If the AppImage won't start and mentions FUSE, install libfuse2 (on Ubuntu 24.04 the package is libfuse2t64), or use the .deb, which doesn't need it. ## Add a server # A server is a machine with no screen that runs your agents: a home server, a spare Mac mini, a cloud VM. You don't download anything by hand: - In the app, open Settings › Devices › Add device and choose a server. - Run the install steps it shows on the server. They work for an hour, for your account only. - The server appears in your devices. It runs as a service, restarts on its own, and updates itself only to signed releases, waiting until no agent is mid-turn. The installer also sets up the agent CLIs and the GitHub sign-in. More on the [server page](https://shuriken.sh/server). ## After installing # Sign in, add a project, and add the accounts or keys your agents should use. Our guide on [setting up Shuriken](https://shuriken.sh/guides/set-up-shuriken) takes it from there. On your phone, the web app at app.shuriken.sh follows every chat until the native iPhone and Android apps arrive, planned for November 2026. Share [X](https://x.com/intent/post?url=https%3A%2F%2Fshuriken.sh%2Fguides%2Finstall-shuriken&text=How%20to%20install%20Shuriken%20on%20Mac%2C%20Windows%20and%20Linux)[LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fshuriken.sh%2Fguides%2Finstall-shuriken)[Hacker News](https://news.ycombinator.com/submitlink?u=https%3A%2F%2Fshuriken.sh%2Fguides%2Finstall-shuriken&t=How%20to%20install%20Shuriken%20on%20Mac%2C%20Windows%20and%20Linux)[Reddit](https://www.reddit.com/submit?url=https%3A%2F%2Fshuriken.sh%2Fguides%2Finstall-shuriken&title=How%20to%20install%20Shuriken%20on%20Mac%2C%20Windows%20and%20Linux)[E-mail](mailto:?subject=How%20to%20install%20Shuriken%20on%20Mac%2C%20Windows%20and%20Linux&body=https%3A%2F%2Fshuriken.sh%2Fguides%2Finstall-shuriken) ## Frequently asked questions **Is the Mac app notarised by Apple?** Yes. Since 5.1, Shuriken for Mac is signed with our Apple Developer ID and notarised by Apple, so it opens without a trip to System Settings. Builds up to 5.0.0 weren't, and needed Open Anyway in Privacy & Security. **Why does Windows say it protected my PC?** SmartScreen warns about apps without a Windows code-signing certificate, which Shuriken doesn't have yet. Choose More info › Run anyway. Updates after that are checked against Shuriken's signature before they install. **What do I need to run Shuriken?** macOS 13 Ventura or later on Apple silicon (M1 or newer); Windows 10 or 11 on x64; or Linux on x64 or Arm, including ChromeOS's Linux. Plus the coding agents you want to use and your own sign-ins for them. **Can I run Shuriken on a server without a screen?** Yes. Add it from the app with Settings › Devices › Add device. The install steps work for an hour, and the server then runs as a service and updates itself to signed releases. **How do I check that my download is genuine?** Download only from shuriken.sh, which serves every file over HTTPS. Once Shuriken is installed, it checks each update against our release key before installing it. Servers Your agents on your own servers. Add a Linux, macOS or Windows server from the app with one command. It runs as a service and updates itself. [Download](https://shuriken.sh/download) [Other platforms](https://shuriken.sh/download#main) ## Keep reading - [Claude Code in a dev container: setup, firewall and auth: Guide 27 Oct 2026 5 min read Claude Code in a devcontainer is one feature line. A named volume and one env variable keep your sign-in through rebuilds; skipping prompts stays unsafe.](https://shuriken.sh/guides/claude-code-devcontainer) - [Claude Code in GitHub Codespaces: setup and sign-in: Guide 27 Oct 2026 7 min read Claude Code runs in GitHub Codespaces through Anthropic's dev container feature, and a personal Codespaces secret keeps each new codespace signed in.](https://shuriken.sh/guides/claude-code-github-codespaces) - [Claude Code on a VPS: sizing, setup and staying safe: Guide 27 Oct 2026 7 min read Claude Code runs on a VPS with 4 GB of RAM, an x64 or ARM64 CPU and Ubuntu 20.04+ or Debian 10+, used from a supported country. How to size and secure it.](https://shuriken.sh/guides/claude-code-on-a-vps) - [Run Claude Code on an always-on machine: Guide 27 Oct 2026 6 min read Run Claude Code on a home server, mini PC or VM that never sleeps: install, headless sign-in, tmux, remote access, or add it as a Shuriken server.](https://shuriken.sh/guides/claude-code-on-an-always-on-machine) - [Run Claude Code on a remote server over SSH: Guide 27 Oct 2026 6 min read Run Claude Code over SSH the right way: sign in on a headless box, keep sessions alive with tmux, handle Git keys safely, and see what SSH alone can't do.](https://shuriken.sh/guides/claude-code-over-ssh) - [Claude Code on a Raspberry Pi: what works: Guide 27 Oct 2026 8 min read Claude Code runs on a Raspberry Pi 4 or 5 with 4 GB of RAM or more and the 64-bit Raspberry Pi OS. Which boards qualify, the 32-bit trap, and the setup.](https://shuriken.sh/guides/claude-code-raspberry-pi) - [Claude Code teleport: pull cloud sessions to your terminal: Guide 27 Oct 2026 6 min read claude --teleport pulls a Claude Code cloud session and its branch into your terminal. It needs a clean tree, the same repo and the same claude.ai account.](https://shuriken.sh/guides/claude-code-teleport-cloud-sessions) - [Claude Code with VS Code Remote-SSH, WSL and containers: Guide 27 Oct 2026 8 min read In a VS Code Remote-SSH, WSL or dev container window, the Claude Code extension runs remotely: sign-in, ~/.claude, MCP servers and the CLI live there.](https://shuriken.sh/guides/claude-code-vscode-remote-ssh) - [Install Claude Code on Linux: Ubuntu, Fedora, Alpine: Guide 27 Oct 2026 8 min read To install Claude Code on Linux, run curl -fsSL https://claude.ai/install.sh | bash, or add Anthropic's signed apt, dnf or apk repository.](https://shuriken.sh/guides/install-claude-code-on-linux) ## Free tools - [Claude limit reset tracker](https://shuriken.sh/tools/limit-resets/claude) - [Codex limit reset tracker](https://shuriken.sh/tools/limit-resets/codex)