Skip to content

Commit

Permalink
Simplify and consolidate quick start installation instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
ginatrapani committed Feb 10, 2012
1 parent 5a0c917 commit 241ae7b
Show file tree
Hide file tree
Showing 4 changed files with 41 additions and 53 deletions.
27 changes: 0 additions & 27 deletions docs/source/install/hostingproviders.rst

This file was deleted.

2 changes: 0 additions & 2 deletions docs/source/install/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,6 @@ everything you need to know to get ThinkUp up and running on your web server.
.. toctree::
:maxdepth: 2

sysreqs
hostingproviders
quickstart
install
advancedconfig
Expand Down
51 changes: 41 additions & 10 deletions docs/source/install/quickstart.rst
Original file line number Diff line number Diff line change
@@ -1,17 +1,48 @@
Quick Start
===========

ThinkUp includes a three-step, web-based installer. To use it:
To run ThinkUp, you'll need a public web server running:

1. `Download the latest distribution of ThinkUp <https://github.com/ginatrapani/thinkup/downloads>`_ under
"Download Packages."
2. Extract the zip file into a web-accessible folder.
3. Visit that URL in your browser and proceed through the installation process.
* `PHP 5.2 <http://php.net/>`_ or higher with `cURL <http://php.net/manual/en/book.curl.php>`_, `GD <http://php.net/manual/en/book.image.php>`_, and the `PDO <http://php.net/manual/en/book.pdo.php>`_ `MySQL driver <http://www.php.net/manual/en/ref.pdo-mysql.php>`_ enabled
* `MySQL 5.0.3 <http://mysql.com/>`_ or higher

Once ThinkUp is installed, log in and click on Settings to activate the plugins of your choice. Click on
each one to configure any necessary API keys or other settings.
Most users purchase server access from a web hosting provider.

To begin capturing your data, log into ThinkUp, and click the "Update now" link in the top left corner to
run the ThinkUp crawler and begin capturing your posts and replies.
Hosting Providers
-----------------

Trouble? Check out the `detailed installation guide <install.html>`_.
We built ThinkUp so that it can run on the most common and widely-available LAMP-based hosting plans. Some providers
offer simple custom ThinkUp launchers.

Automatic ThinkUp Launchers
^^^^^^^^^^^^^^^^^^^^^^^^^^^

If you don't have a web server hosting package and don't want to get one, one of these options is best for you:

* `PHP Fog <http://phpfog.com>`_ offers `free hosting (up to 20MB) and a simple ThinkUp installer
<http://expertlabs.org/2011/12/php-fog-adds-free-thinkup-hosting.html>`_.
* Our `Amazon EC2 launcher <http://expertlabs.aaas.org/thinkup-launcher/>`_ spins up an Amazon web server and installs
ThinkUp on it for you; free for the first year and costs around $15/month after that.

Known Incompatibilities
^^^^^^^^^^^^^^^^^^^^^^^

Some web hosting providers or plans have known incompatibilities with ThinkUp. Several ThinkUp users report that:

* Dreamhost's least expensive shared hosting package :doc:`may time out when gathering data for busy
accounts </troubleshoot/common/prematureend>`. Dreamhost's 300MB VPS server (which costs around $15/month) will not.
* GoDaddy's shared hosting plan triggers :doc:`database server timeout errors </troubleshoot/common/mysqlgoneaway>`.

Have notes about your ThinkUp hosting provider that should appear on this page? Please post them to the
`ThinkUp mailing list <http://groups.google.com/group/thinkupapp>`_.

Install ThinkUp in Three Steps
------------------------------

Once you have access to a public web server to install ThinkUp, install it in three easy steps.

1. `Download the latest distribution of ThinkUp <https://thinkupapp.com/download/>`_.
2. Extract the zip file into a web-accessible folder on your web server via FTP.
3. Visit that URL in your browser to proceed through ThinkUp's simple installer.

Trouble? Check out the `detailed installation guide <install.html>`_.
14 changes: 0 additions & 14 deletions docs/source/install/sysreqs.rst

This file was deleted.

0 comments on commit 241ae7b

Please sign in to comment.