After installing Storj the application should be configured to fully integrate with the add-on.

Local setup

Environment setup

After provisioning the add-on it’s necessary to locally replicate the config vars so your development environment can operate against the service.

Use the Heroku Local command-line tool to configure, run and manage process types specified in your app’s Procfile. Heroku Local reads configuration variables from a .env file. To view all of your app’s config vars, type heroku config. Use the following command for each value that you want to add to your .env file.

$ heroku config:get ADDON-CONFIG-NAME -s >> .env

Credentials and other sensitive configuration values should not be committed to source-control. In Git exclude the .env file with: echo .env >> .gitignore.
For more information, see the Heroku Local article.

Service setup

Storj can be configured for use in a local development environment. To do this, you would export the environment variables mentioned above in Environment setup. You will then be able to run your service locally and it will talk to the Storj API.

You can install the Storj CLI to interact with your buckets and files using the following command. To use this, you must have Node.js and NPM installed.

$ npm install -g storj

Using with Node.js

Node.js applications will need to add the following entry into their package.json specifying the storj client library.

We also encourage the use of NVM which allows you to install multiple versions of Node.js on the same host. For help installing and configuring Node.js via NVM, please reference the Node Version Manager page.

Using with other languages

To use Storj from languages other than Node.js, please refer to our API Documentation

Troubleshooting

If you have any issues we have a public community chat you can join here. Community members and staff are there to help people there 24/7.

Migrating between plans

Application owners should carefully manage the migration timing to ensure proper application function during the migration process.
Migration is simple! Use the heroku addons:upgrade command to migrate to a new plan.