#chrome-os #chromebook #nix #homebrew #docker #linux-distro #cli-tool


A simple CLI tool to quickly setup your development environment on Chomebook (ChromeOS) or any Linux Distribution

1 unstable release

0.1.0 Jun 14, 2023

#773 in Unix APIs

23 downloads per month
Used in crosup

MIT and LGPL-3.0-or-later

135 lines

Crosup 🐧 💻 🚀 ✨

release License: MIT

Crosup is a CLI tool to help you quickly setup your development environment on a new Chromebook (ChromeOS) or any Linux distribution. It is designed to be simple and easy to use.

✨ Features

  • Compatible with ChromeOS, Debian-based Linux, OpenSUSE, Fedora, RedHat, CentOS, Alpine and more!
  • Detects your OS and installs the appropriate tools
  • HCL/TOML configuration file
  • Installs developer tools like docker, nix, devbox, homebrew, flox, fish, vscode, ble.sh, atuin, tig, fzf, httpie, kubectl, minikube, tilt, zellij, ripgrep, fd, exa, bat, glow, devenv and more!

🚚 Installation

bash <(curl -sSL https://raw.githubusercontent.com/tsirysndr/crosup/master/install.sh)

Compiling from source:

git clone https://github.com/tsirysndr/crosup.git
cd crosup
nix develop --experimental-features "nix-command flakes"
cargo install --path crates/cli

📦 Supported OS

  • ChromeOS (Debian Container)
  • Debian-based Linux
  • OpenSUSE
  • Fedora
  • RedHat
  • CentOS
  • Alpine
  • Arch
  • Gentoo
  • Slackware

🚀 Usage

             ______                __  __
            / ____/________  _____/ / / /___
           / /   / ___/ __ \/ ___/ / / / __ \
          / /___/ /  / /_/ (__  ) /_/ / /_/ /
          \____/_/   \____/____/\____/ .___/

Quickly install your development tools on your new Chromebook or any Linux distribution

    crosup [SUBCOMMAND]

    -h, --help       Print help information
    -V, --version    Print version information

    add        Add a new tool to the configuration file
    diff       Show the difference between the current configuration and the previous one
    help       Print this message or the help of the given subcommand(s)
    history    Show the change history of the configuration file
    init       Generate a default configuration file
    install    Install developer tools, e.g. docker, nix, devbox, homebrew, fish, vscode, ble.sh
    search     Search for a package in the nixpkgs repository

🛠️ Minimal Configuration

This is a minimal configuration file to install vim and git:

# Crosfile.toml
packages = [

When you run crosup install, it will detect your OS and install the appropriate tools using nix home-manager on your system.

📝 Advanced Configuration

Crosup uses a configuration file to determine which tools to install. The default configuration is embedded in the binary, but you can generate a default configuration file (Crosfile.hcl) using the crosup init subcommand, you can specify the default format using the --toml flag.

Example of a Crosfile.toml (crosup init --toml) for a Debian-based system:

# Crosfile.toml
preinstall = "sudo apt-get install -y qemu-system libvirt-clients libvirt-daemon-system"
postinstall = """
sudo sed -i 's/#user = \"root\"/user = \"root\"/g' /etc/libvirt/qemu.conf
            sudo sed -i 's/#group = \"root\"/group = \"root\"/g' /etc/libvirt/qemu.conf
            sudo sed -i 's/#dynamic_ownership = 1/dynamic_ownership = 0/g' /etc/libvirt/qemu.conf
            sudo sed -i 's/#remember_owner = 1/remember_owner = 0/g' /etc/libvirt/qemu.conf"""


version_check = "kubectl"








version_check = "http"




version_check = "rg"

version_check = "nvim"

url = "https://github.com/akinomyoga/ble.sh.git"
install = "make -C ble.sh install PREFIX=~/.local"
preinstall = "sudo apt-get install -y gawk build-essential"
postinstall = "echo 'source ~/.local/share/blesh/ble.sh' >> ~/.bashrc"
install_check = "~/.local/share/blesh/ble.sh"
recursive = true
depth = 1
shallow_submodules = true

impure = true
experimental_features = "nix-command flakes"
accept_flake_config = true
preinstall = "echo 'extra-trusted-substituters = https://cache.floxdev.com' | sudo tee -a /etc/nix/nix.conf && echo 'extra-trusted-public-keys = flox-store-public-0:8c/B+kjIaQ+BloCmNkRUKwaVPFWkriSAd0JJvuDu4F0=' | sudo tee -a /etc/nix/nix.conf"
flake = "github:flox/floxpkgs#flox.fromCatalog"

flake = "github:cachix/cachix"

accept_flake_config = true
preinstall = """
echo \"trusted-users = root $USER\" | sudo tee -a /etc/nix/nix.conf
sudo pkill nix-daemon
cachix use devenv"""
flake = "github:cachix/devenv/latest"
depends_on = ["cachix"]

url = "https://get.jetpack.io/devbox"
shell = "bash"
depends_on = ["nix"]

FORCE = "1"

url = "https://raw.githubusercontent.com/ellie/atuin/main/install.sh"
shell = "bash"

url = "https://install.determinate.systems/nix"
enable_sudo = true
args = "install --no-confirm"

url = "https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh"
postinstall = "echo 'eval $(/home/linuxbrew/.linuxbrew/bin/brew shellenv)' >> ~/.bashrc"
version_check = "brew"
shell = "bash"


gpg_key = "https://download.docker.com/linux/debian/gpg"
gpg_path = "/etc/apt/keyrings/docker.gpg"
setup_repository = "echo \"deb [arch=\"$(dpkg --print-architecture)\" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian \"$(. /etc/os-release && echo \"$VERSION_CODENAME\")\" stable\" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null"
apt_update = true
packages = [
depends_on = [
postinstall = "sudo usermod -aG docker $USER && newgrp docker"

url = "https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-x64"
version_check = "code"

🚀 As a GitHub Action

You can use crosup as a GitHub Action to install developer tools on your CI/CD pipeline.

name: Setup Crosup
      - master
      - master

    runs-on: ubuntu-latest
    continue-on-error: true
      - name: Install Nix
        uses: DeterminateSystems/nix-installer-action@v4
      - name: Setup Crosup
        uses: tsirysndr/setup-crosup@v1
          version: 'v0.5.0'
          # Add packages to install here
          packages: |
      - name: Verify Crosup
        run: crosup --version
      - name: Verify Deno
        run: deno --version
      - name: Verify Zig
        run: zig version

See action.yml for the full documentation for this action's inputs and outputs.

🤝 Contributing

Contributions, issues and feature requests are welcome! See CONTRIBUTING for more information.

📝 License



~338K SLoC