https://github.com/wolverian/box

box! is full of boxes
https://github.com/wolverian/box

Last synced: 12 days ago
JSON representation

box! is full of boxes

• Host: GitHub
• URL: https://github.com/wolverian/box
• Owner: wolverian
• License: isc
• Created: 2013-02-06T15:09:54.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2014-01-14T21:20:59.000Z (about 11 years ago)
• Last Synced: 2025-01-20T00:49:48.296Z (12 days ago)
• Language: Shell
• Size: 396 KB
• Stars: 6
• Watchers: 3
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Box is full of boxes

> I just *know* I have a Debian box somewhere…

![Box in action](screenshot.png)

Do you have more than π boxes? Are you constantly forgetting about them?

With Box you can easily:

- Keep inventory of your boxes:

        $ box ls

        [email protected]

        [email protected]

        [email protected]

- Check if they're up:

        $ box uptime

        [email protected] | 15:29:49 up 24 days, 3:07, 2 users, load average: 0.00, 0.01, 0.05

        [email protected] | 3:29PM up 17 days, 3:31, 1 user, load averages: 0.20, 0.14, 0.09

        [email protected] | 3:29PM up 42 days, 1:44, 15 users, load averages: 1.30, 1.94, 1.88

- Remind yourself what you put in those boxes:

        $ box id

        [email protected] | Linux foo 3.5.0-17-generic i686

        [email protected] | NetBSD bar 6.0.1 amd64

        [email protected] | Linux quux 2.6.34-generic amd64

All this and more, for the low price of *nothing*! Get Box today!

## Overview

Box is a remote command execution program. Box allows you to run commands on

all of your servers and presents the produced results in a readable format.

Box is liberally licensed with the [ISC license][].

In the future, Box will likely morph into a minimal configuration management

system.

## Who Box is for

Box is designed for managing at most twentyish boxes. If you have a larger

deployment, we recommend that you use tools like [Ansible][], [Salt Stack][],

[Chef][] or [Puppet][] (in roughly increasing order of complexity).

## Requirements

- A POSIX `/bin/sh` implementation on boxes and on the controlling machine.

- Access to boxes with an SSH key.

- Box runs commands in parallel on each box if [GNU Parallel] is installed.

## Getting started

Box doesn't have a an installation method yet. You can run it easily from a

Git clone, though:

    git clone [email protected]:wolverian/box.git

    cd box

    echo [email protected] >> etc/hosts

    echo [email protected] >> etc/hosts

    PATH=bin:$PATH

    box tasks

    …

    box id

    …

## Troubleshooting

### I can't enter my server password

Box requires that you use SSH keys for authentication.

[GNU Parallel]: http://www.gnu.org/software/parallel/

[Salt Stack]: http://saltstack.org

[Chef]: http://www.opscode.com/chef/

[Puppet]: https://puppetlabs.com

[Ansible]: http://ansible.cc

[ISC license]: LICENSE