Last update: 11/17/2012; 9:39:52 PM.

Setting up a Radio2 server

What is Radio2? permalink

Radio2 is linkblogging software.

For a user-oriented intro to Radio2 see the docs page.

Here we show you how to set up a Radio2 server.

Requirements permalink

1. An Amazon S3 account. Be prepared to enter the Access Key Id and Secret Key.

2. An S3 bucket to store Radio2 feeds in. You should write down the path to that bucket and the URL you use to access it in a web browser.

3. A password for your Admin account, so you can access the server over the net.

Use S3 for Poets permalink

I wrote a tutorial that shows you how to set up an Amazon S3 bucket.

It's a useful skill, for more than running a linkblogging tool.

Install the OPML server permalink

The first step is to install the OPML Server on an Internet-accessible machine.

You could follow the EC2 for Poets tutorial.

Or install it on your own server from the main OPML Editor site.

No matter how you install the software, be sure it's fully updated. To do so, bring the OPML app to the front and choose Update opml.root from the File menu. Click on OK to the confirmation prompt. When it's done it will tell you how many new parts it installed.

Once the OPML app is installed and running, you can install Radio2.

Does it have to be Internet-accessible? permalink

Actually it doesn't. You can install it on your laptop and take it with you everywhere you go.

But if you want to post a link from your smartphone or while traveling, you need to have it on a server.

Installing Radio2 permalink

Be sure the OPML app is running.

Bring the OPML app to the front.

Choose Tool Catalog from the Misc menu.

Click on the Install link next to Radio2.

A dialog will appear confirming that you want to install the Radio2 app. Click OK.

When it's done, this page will open in the web browser.

Setup for Radio2 permalink

With the OPML app running on your server, choose Preferences from the Misc menu.

1. If you haven't already gotten an Admin password from EC2 for Poets, visit that prefs page, and choose a password. Later you'll log in to Radio2 with this password.

2. Set up your Amazon S3 account information. This is where feeds and HTML pages will be saved by Radio2.

3. In the Radio2 preferences section enter the path to your S3 bucket.

4. Optionally set up the URL shortener function.

Once you're set up permalink

If you're accessing Radio2 from the browser on the server machine, enter this URL:

If you're accessing it over the Internet, you can find out what the name of your machine is by visiting the External Name prefs page. If you're running it on Amazon EC2, you can access Radio2 through a URL something like this:

If you get a username/password dialog, your username is admin, and the password is the one you entered in step 1 in the previous section.

The Docs for Radio2 are linked into the top of the page of the website so they're always easy to find.

The menu in the upper right corner of the screen, when you're logged on as Admin, gets you back to the OPML Server website, where you can change various prefs that control all apps running on the server. You can create additional accounts with the New User command. You can give them admin-like powers with the Prefs command. This is useful if there are other people who you want to be able to manage the system or if you want to use a name other than "admin" to blog with. :-)

If you have questions, you can post them on the Frontier-user mail list.

Setting up the URL shortener permalink

You have three choices: 1. Don't use a URL shortener. 2. Use the urlShortener app we provide. 3. Use

The advantages of using a shortener should be familiar to you. If you use our shortener you will get hit count information included on your Radio2 home page.

You can use your own domain with either URL shortener, so you can put "branding" on your posts, if you're into that.

Using as your URL shortener permalink

Start with a Radio2 setup that works.

Go to the OPML Server website, Prefs, Radio2 section, URL shortener. If you want to access this page from the browser running on the server machine, enter this URL.

Check the first box, to enable URL shortening. Check the second box, saying you want to shorten URLs with Enter your username, and your API Key.

This is what the Radio2 prefs page should look like when you're done.

How to find your API key permalink

Log in to

In the upper-right corner, click on your name (it's after the word Ahoy). A dropdown is revealed. Click on Settings.

Several panels appear, the last is Advanced, click on it.

Near the bottom click on Show legacy API key.

Select the text, copy it.

blog comments powered by Disqus

Last udpate: 11/17/2012; 9:39:52 PM.