Skip to content

Axiom Demo

The quickest way to try out Axiom for yourself is to run our desktop demo which allows you to run an entire Axiom deployment, including data-shippers, right on your desktop via Docker.

By running this demo, you will have an Axiom instance, Postgresql, Minio plus some data-shipper containers. The demo makes it simple to check out many of Axiom's features as well as compatibility with data-shippers and API-based tools.

The Axiom Demo configuration is open source and we would love your feedback and ideas to make it better!

Running the Demo

This requires Docker and docker-compose to be installed:

git clone https://github.com/axiomhq/axiom-demo.git
cd axiom-demo
docker-compose up -d

Open your browser to :8080 and log in with these credentials:

Email: demo@axiom.co
Password: axiom-d3m0

For api access (i.e. with the cli) there is a personal access token: 274dc2a2-5db4-4f8c-92a3-92e33bee92a8.

See stopping the stack for instructions to tear it down again.

CLI

In addition to the frontend you can play around with the Axiom CLI.

On macOS/Linux you can use Homebrew to install it with:

brew tap axiomhq/tap
brew install axiom

See the CLI installation docs for other installation methods.

Authorize the CLI

Log into your axiom-demo deployment like this:

echo 274dc2a2-5db4-4f8c-92a3-92e33bee92a8 | axiom auth login --url="http://localhost:8080" --alias="axiom-demo" --token-stdin --token-type personal -f

Using the CLI

Run axiom --help to see what commands are supported. Here are a few examples:

# List all datasets
axiom dataset list

# Get detailed information about a single dataset
axiom dataset info minio-traces

# List dataset stats
axiom dataset stats

# Stream logs into your terminal
axiom stream postgres-logs

# Create a dataset
axiom dataset create --name my-dataset --description "My dataset"

# Ingest into a dataset
axiom ingest my-dataset < file.json

Stopping the Demo

Run docker-compose stop to stop the stack, docker-compose start to start it again.

If you want to clean up, run docker-compose down -v to remove all containers and volumes. The docker images will persist on your machine unless you manually delete them.