These instructions show you how to set up River4 to work with Amazon S3 storage.
A node.js installation.
An Amazon account, and an S3 bucket to store the JSON files, and a small HTML file.
One or more OPML subscription list files.
Create an S3 bucket to hold all your subscription lists, rivers, and data for the aggregator.
On the node.js system, set an environment variable, s3path, to contain the path to the bucket created in step 1.
Again, on the node.js system, set the two AWS environment variables. This allows the River4 app to write to your bucket.
Launch river4.js on a node.js system. Suppose that server is aggregator.mydomain.com.
Look in the bucket. You should see a data folder, with a single file in it containing the default value of prefs and stats for the app. There's also an index.html file, which will display your rivers in a simple way, providing code you can crib to create your own way of browsing (room for improvement here, for sure).
Create a folder at the top level of the bucket called "lists". Save one or more OPML subscription lists into that folder.
After a while you should see a new folder called "rivers" created automatically by the software. In that folder you should see one JSON file for each list. It contains the news from those feeds, discovered by River4. This format is designed to plug into the beautfiul" river displayer.
If you want to watch the progress of the aggregator, you can view this page.