Upstash

Upstash

Upstash provides a serverless Redis database, which can be used as a key-value store of up to 1mb with a free account.

1. Create an Upstash account

Go to https://console.upstash.com/login

2. Create a database

  1. Click Create database
image
  1. Name: whatever you want.
  2. Type: Regional
  3. Region: Iowa (us-central1), because it’s closest to Val Town’s servers.
  4. Enable TLS for security.
image

3. Add REST credentials to Val Town Secrets

  1. Go to val.town/settings/secrets
  2. For UPSTASH_REDIS_REST_URL and the UPSTASH_REDIS_REST_TOKEN each:
    1. Click New secret.
    2. Set the names to upstashURL and upstashToken, respectively
    3. Copy & paste in the value
    4. Click Add

Upstash:

image

Val Town:

image

4. Set some data!

If you set it up correctly, you should be able to copy & paste this Val and have it return the same results from your own Upstash database

5. Saving JSON

JSON is automatically stringified and parsed so you can set it and get it directly. You can store a JSON object of up to 1mb this way with a free acount.

6. Further resources

  1. Upstash Redis SDK Docs
  2. Redis tutorial

Thanks to @mattx for contributions to this resource!