Quickstart

Installation

Crul is currently available as a MacOS application or a Docker image. Reach out for an enterprise SaaS crul deployment, a self hosted enterprise variant, or to request another distribution.

Mac OS 🍎

Download

Start by downloading the crul-vlatest.tar.gz (MacOS Desktop Application) from the Account page. You'll need to sign up for an account if you have not already.

Decompress

Relax your shoulders, take a deep breath and oh, double click on the downloaded crul-vlatest.tar.gz file to decompress.

Open

Open the decompressed crul application. Crul will prompt itself to move to the /Applications directory if it is not already there. Once approved, crul will reopen.

Docker 🐳

NOTE: The docker variant of crul is stateless, meaning that credentials, frozen results, and other stateful content will not persist once a container has been shut down. This also impacts upgrades.

A resolution to this issue (using docker volumes) is currently being tested and documented, and will be available soon.

Prerequisites

Ensure docker is installed.

docker --help

Download the image

Start by downloading the crul-docker-vlatest.tar.gz (Docker Image) from the Account page. You'll need to sign up for an account if you have not already.

Load the image

In a terminal, first navigate to the directory containing the downloaded crul-docker-vlatest.tar.gz file, then run the following command to load the image.

docker load -i crul-docker-vlatest.tar.gz

Once loaded, you will be able to run the image at anytime without needing to reload.

Run the image

docker run -it --rm -p 2001:2001 -p 1968:1968 -p 2013:2013 --name crul crul:latest

Access the web application

By default, crul runs on http://localhost:2001. Open this page in your browser of choice, crul will load after ~10-60 seconds.

Anatomy of the crul query page

Choose your own adventure

Crul works well with both API and web content, so this quickstart is split into two paths, one path focused primarily on interacting with a webpage, and the other path focused on interacting with an API.

While both are pretty cool (and you ought to try them both!), you may be drawn to one before the other.

Choose where to start your crul adventure below!

• Quickstart 1 (API focused):
  • Querying the Github API with crul for expired GPG keys
• Quickstart 2 (Webpage focused):
  • Retrieving comments from top posts on Hacker News