Skip to main content

Getting Started

Quick start​

Install CLI​

The quickest way to get started is with our CLI. You can install the Momento CLI using our Homebrew tap:

brew tap momentohq/tap
brew install momento-cli

To verify the CLI was installed correctly, you can run our help command:

$ momento --help
momento 0.12.8
CLI for Momento APIs

USAGE:
    momento [OPTIONS] <SUBCOMMAND>

OPTIONS:
    -h, --help       Print help information
    -V, --version    Print version information
        --verbose

SUBCOMMANDS:
    account      Manage Accounts
    cache        Cache Operations
    configure    Configure Momento Credentials
    help         Print this message or the help of the given subcommand(s)

Obtain an auth token​

Authentication in Momento is done via an authentication token, and you can sign up for a Momento auth token directly from the command line.

Authentication tokens are associated with a specific Momento region. You can provision an auth token for a region using the account command with your desired region:

$ momento account signup --region us-west-2 --email your-email@example.com

Be sure to replace your-email@example.com with your actual email address.

Momento will email your auth token to you. You can configure your local CLI to use this token by running the momento configure command:

$ momento configure
Token: // < Enter token from email here.
Default Cache [default-cache]: my-first-cache // Name of cache to use on CLI by default.
Default Ttl Seconds [600]: 30 // Sets the default TTL for cache entries. For demostration purposes we are setting this lower right now.
[2022-03-31T15:31:25Z INFO  momento::commands::cache::cache_cli] creating cache...
[2022-03-31T15:31:33Z INFO  momento::commands::configure::configure_cli] default cache successfully created

You are now up and running with Momento! Let's see how to use the Momento CLI to cache data in Momento.

Cache some data​

The cache command in the Momento CLI is used to interact with your Momento cache. Let's see a few of these commands in action.

First, you can use the set subcommand to store an item in your default Momento cache:

$ momento cache set --key test --value value
[2022-03-31T15:45:17Z INFO  momento::commands::cache::cache_cli] setting key: test into cache: my-first-cache
[2022-03-31T15:45:18Z INFO  momento::commands::cache::cache_cli] set success

Then, you can retrieve the key using the get subcommand:

$ momento cache get --key test
[2022-03-31T15:45:25Z INFO  momento::commands::cache::cache_cli] getting key: test from cache: my-first-cache
value

In configuring the cache, we set a default TTL of 30 seconds. If you wait 30 seconds and try to retrieve the cache again, you will see the item has disappeared:

$ sleep 30 // wait for item to expire
$ momento cache get --key test
[2022-03-31T15:46:02Z INFO  momento::commands::cache::cache_cli] getting key: test from cache: my-first-cache
[2022-03-31T15:46:03Z INFO  momento::commands::cache::cache_cli] cache miss

These are the standard get and set data plane operations with the Momento CLI.

You can also manage control plane operations with the Momento CLI, such as creating a cache, deleting a cache, or listing available caches.

You can see all of the available subcommands in the cache command by using the momento cache --help flag in your terminal:

$ momento cache --help
momento-cache
Cache Operations

USAGE:
    momento cache [OPTIONS] <SUBCOMMAND>

OPTIONS:
    -h, --help       Print help information
        --verbose

SUBCOMMANDS:
    create    Creates a Momento Cache
    delete    Deletes the cache
    get       Gets item from the cache
    help      Print this message or the help of the given subcommand(s)
    list      Lists all momento caches
    set       Stores a given item in cache

Further, you can specify non-default configuration options for your commands, such as a different region, cache name, or TTL.

For more information about any of the parameters for a subcommand, you can use momento cache $SUBCOMMAND --help to learn more.

Next steps​

The CLI is great for testing and for understanding the core Momento API, but most of your caching work will be done in your application. For those, you can use the Momento SDKs.

We currently have the following SDK's languages availabile.

Check out our examples repo for hands-on examples with the various SDKs.