Skip to content
a fork of instiki that runs on heroku. follows 80% use case worst practices to make the code quickly deployable..
Ruby JavaScript Other
Find file
Failed to load latest commit information.
app textile markup helper Mar 10, 2011
attic Ruby 1.9 Compatibility Nov 30, 2009
cache Added empty directories because Git is stupid. Feb 5, 2009
components Added empty directories because Git is stupid. Feb 5, 2009
config might not need to require secure random if i cut it out Oct 10, 2010
db deleted some accidental commits Mar 20, 2011
dump/fixtures Added empty directories because Git is stupid. Feb 5, 2009
lib Merge branch 'bzr/golem' of /Users/distler/Sites/code/instiki Jan 3, 2010
natives/osx/desktop_launcher Checkout of Instiki Trunk 1/21/2007. Jan 22, 2007
public textile markup helper Mar 10, 2011
script Better handling of pathnames with spaces Dec 28, 2009
storage Added empty directories because Git is stupid. Feb 5, 2009
tmp Merge branch 'bzr/golem' of /Users/distler/Sites/code/instiki Oct 11, 2009
vendor More Array -> Set Jan 2, 2010
webs Make sure we ignore any generated file in webs Sep 5, 2009
.gitignore ignore some stuff Mar 20, 2011
CHANGELOG Release Instki 0.18.1 Jan 7, 2010
Gemfile Response to issue 4 on Github Jan 7, 2013
README Added backup instructions for heroku Mar 20, 2011
UPGRADING Version 0.17.3 Oct 23, 2009
instiki Bugfixes and Rails Edge Feb 27, 2009
instiki.bat New Version Oct 15, 2007
instiki.cmd Checkout of Instiki Trunk 1/21/2007. Jan 22, 2007
instiki.rb Checkout of Instiki Trunk 1/21/2007. Jan 22, 2007
rakefile.rb Clean up file permissions Aug 29, 2009


= Instiki

Instiki is a wiki clone so pretty and easy to set up, you'll wonder if it’s really a wiki. Runs on Rails and focuses on portability and stability. Supports file uploads, PDF export, RSS, multiple users and password protection. Some use Instiki as a CMS (Content Management System) because of it's ability to export static pages.

Instiki lowers the barriers of interest for when you might consider using a wiki. It's so simple to get running that you'll find yourself using it for anything -- taking notes, brainstorming, organizing a gathering.

== Supported Platforms

This fork is designed for deploying instiki to Heroku. I recommend using the
real release version if you wish to run it anywhere else. Download the source at

Note for Heroku read-only filesystem: file uploads are disabled by default.

== 5 easy Steps to get the Instiki on Heroku experience

git clone git://
cd instiki-heroku
heroku create
git push heroku master
heroku rake db:migrate

=== If you are on Linux

You are already rad, you got this. Follow the 5 step program

=== If you are on Mac OSX

Install git and heroku and follow the 5 step program.

=== If you are on Windows

You may be screwed, but I don't know because I recommend running Debian
GNU/Linux for everything except for entertaining yourself, for that I recommend
MacOS X.

=== Backing up on Heroku.

== Features

* Regular expression search: Find deep stuff really fast
* Revisions: Follow the changes on every page from birth. Rollback to an earlier rev
* Export to HTML or markup in a zip: Take the entire wiki with you home or for reference
* RSS feeds to track recently revised pages
* Multiple webs: Create separate wikis with their own namespace
* Password-protected webs: Keep it private
* Authors: Each revision is associated with an author, so you can see who changed what
* Reference tracker: Which other pages are pointing to the current?
* Five markup choices:
   Markdown-based choices []:
     Markdown+itex2MML (the default; requires itex2MML) 
     Markdown+BlahTeX/PNG (requires blahtex and a working TeX installation
   Textile []
   RDoc []
* Embedded webserver: uses Mongrel (if installed), or the bundled WEBrick webserver (if not).
* Internationalization: Wiki words in any latin, greek, cyrillian, or armenian characters
* Color diffs: Track changes through revisions
* Runs on SQLite per default, can be configured to run on PostgreSQL, MySQL, DB2, Firebird, Openbase, Oracle, SQL Server or Sybase

== History:


== Migrating from Instiki 0.11-0.12 to 0.16.3

   rake upgrade_instiki

== Migrating Instiki 0.10.2 storage to Instiki 0.11.0 database

1. Install Instiki 0.11 and check that it works (you should be able to create a web, edit and save a HomePage)
2. Execute 
      ruby script\import_storage \
          -t /full/path/to/instiki0.10/storage \
          -i /full/path/to/instiki0.10/installation \
          -d sqlite (or mysql, or postgres, depending on what you use) \
          -o instiki_import.sql
   for example (Windows):
   ruby script\import_storage -t c:\instiki-0.10.2\storage\2500 -i c:\instiki-0.10.2 -d sqlite -o instiki_import.sql
3. This will produce instiki_import.sql file in the current working directory. 
   Open it in a text editor and inspect carefully.
4. Connect to your production database (e.g., 'sqlite3 db\prod.db'), 
   and have it execute instiki_import.sql (e.g., '.read instiki_import.sql')
5. Execute ruby script\reset_references 
   (this script parses all pages for crosslinks between them, so it may take a few minutes)
6. Restart Instiki
7. Go over some pages, especially those with a lot of complex markup, and see if anything is broken.

The most common migration problem is this: if you open All Pages and see a lot of orphaned pages, 
you forgot to run ruby script\reset_references after importing the data.

===Upgrading from Instiki-AR Beta 1

In Beta 2, we switch to ActiveRecord:Migrations. Therefore:
1. Back up your production database.
2. Open command-line session to your database and execute: 
  create table schema_info (version integer(11)); 
  insert into schema_info (version) values (1);
3. Go back to the shell, change directory to the new Instiki and execute "rake migrate".

Step 2 creates a table that tells to ActiveRecord:Migrations that the current version 
of this database is 1 (corresponding to Beta 1), and step 3 makes it up-to-date with
the current version of Instiki.

== Download the latest release from:


== Visit the "official" Instiki wiki:


== License:

* same as Ruby's



Versions 0.0 to 0.9.1:: David Heinemeier Hansson
Email::  david[AT]

From 0.9.2 onwards:: Alexey Verkhovsky
Email:: alex[AT]

From 0.11 onwards:: Matthias Tarasiewicz and
Email:: parasew[AT]

From 0.13 onwards:: Matthias Tarasiewicz and Jacques Distler
Email:: instiki-devel[AT]
Weblog Jacques:
Weblog Parasew:
Something went wrong with that request. Please try again.