Installation - matigo/Noteworthy GitHub Wiki

Here's how to install Noteworthy on a basic LAMP server with a barebones installation of all software. Just how barebones? Here is my main server's current setup:

  • CentOS
  • Apache 2.2.15
  • MySQL 5.1.66 (Server & Client Components)
  • PHP 5.3.3 (Common, MySQL, mbstring, & Devel Components)

That's all.

Copying the Files

Copy the Noteworthy installation files to your directory of choice and ensure the web root directory is either owned by the web user (usually apache on many Linux distributions), and preferably configured with nothing greater than 755 permissions. No directory should ever be 777 (and future versions will yell, kick, and scream if any file or directory is 777).

Installing and Configuring Noteworthy

No text files need to be edited before you can use the software. Once the basic files are in the necessary directory, you should be able to visit the page and see the a very basic website titled "Ambling Down the Path" - A Quick & Dirty Noteworthy-Powered Website. If you can see this, the software is ready to be used. So let's configure it!

Point your browser to /install/ and hit Enter. From here, so long as the software hasn't been configured already, you'll see a blue screen with a single text field requesting an email address. This is your login. No password is ever required with Noteworthy. From here, you can begin to configure the software for your needs. I suggest doing it the following way:

  • Start with the "Settings" tab, entering the necessary MySQL connection information
  • Go to "Sites" and set up the website's name, commenting system, and other items.
  • For automatic updates of Evernote and Tweet records, enable the "Update Handling" section.
  • Get your Evernote Developer Token (if you don't already have one), enter it in the appropriate field, and hit the "Connect to Evernote" button. If the key is good, then you should see a list of your notebooks.
  • Choose the notebooks you want to have imported to your website and click "Save Selected Notebooks"

And that's pretty much it. You can click the "Import Notes" button next to the Evernote Notebook grid or, if you have the "Update Handling" enabled, visit the website (it will still be empty) as that will trigger the data collection cron job. Depending on how many notes and Tweets you're importing, this process should be done in just a few minutes. In my case, I have imported 1,700 notes and 2,900 Tweets in about 12 minutes.

Have questions? You can get in touch with me through here, on Twitter, and through my website.

Enjoy!