Skip to content

Netsoc CLI

Manage our services from the command line!

Tip

You can skip installing the CLI on your own machine with SSH! See here for more info.

Getting started

To get started with the CLI, you'll need to download the latest release from GitHub.

Note

Unless your're on an old 32-bit system, always choose the amd64 variant of the binary (even if you have an Intel CPU!). If you're on a Raspberry Pi, pick the linux-arm-7 variant.

  1. Use your favourite AUR helper to install the netsoc package. For example with yay: 
    yay -S netsoc
  1. Download cli-linux-<arch> (almost certainly amd64)

  2. Make the binary executable: 

    chmod +x Downloads/cli-linux-amd64

  3. Move and rename the program into somewhere on your $PATH (so you can run it directly!), for example: 

    sudo mv Downloads/cli-linux-amd64 /usr/local/bin/netsoc

  1. Download cli-darwin-10.12-amd64 (switch amd64 to arm64 on Apple Silicon)

  2. Make the binary executable: 

    chmod +x Downloads/cli-darwin-10.12-*

  3. Move and rename the program into somewhere on your $PATH (so you can run it directly!), for example: 

    sudo mv Downloads/cli-darwin-10.12-* /usr/local/bin/netsoc

  1. Download cli-windows-4.0-<arch>.exe (almost certainly amd64)
  2. Rename the file to netsoc.exe (exclude the .exe if you don't see it on the downloaded file)
  3. Move the file to somewhere you'll remember, e.g. C:\tools\netsoc.exe
  4. Open a PowerShell terminal and cd to where you copied the file, for example: 
    cd C:\tools

You should now be able to run the CLI from your terminal as netsoc (on Windows make sure you're in the directory you copied the .exe to and use .\netsoc.exe instead).

Using the CLI

Once installed, you need to log in to your account. To do this, run the following:

# Replace `myusername` with your Netsoc username!
netsoc account login myusername

Now that you're logged in, you should be able to use the CLI! To make sure everything is working, run:

$ netsoc account info
╭────┬──────────┬─────────────────┬─────────────────┬─────────────────────╮
│ ID │ USERNAME │ EMAIL           │ NAME            │ RENEWED             │
├────┼──────────┼─────────────────┼─────────────────┼─────────────────────┤
│ 3  │ dev      │ osullj19@tcd.ie │ Jack O'Sullivan │ 2020-09-27 20:47:14 │
╰────┴──────────┴─────────────────┴─────────────────┴─────────────────────╯
$

See the command reference for more details on commands provided by the CLI.

Last update: 2021-07-27