Skip to content
This repository has been archived by the owner on Nov 9, 2017. It is now read-only.
spladug edited this page Jun 3, 2012 · 33 revisions

Basic Information

Under what license is reddit released?

The CPAL. See https://github.com/reddit/reddit/blob/master/LICENSE

Is this all of the code?

Our anti-cheating/spam code is not public. In the source itself, anything under the package r2admin falls under this, so it's easy to see where that begins and ends. Our private code is not required to run a successful clone.

Installation Troubleshooting

How can I figure out which part of the system is broken?

$ sudo svstat /service/*

Look for services that have an uptime much smaller than the rest of the services. Once you've found one, check its logs for errors

$ tail -F /service/broken-service/log/main/current

I'm seeing an error. What should I do?

Error Resolution
ImportError: No module named wrapped You need to compile the Cython modules.
$ cd ~/reddit/r2
$ make
</td>
ImportError: No module named rails.asset_tag setup.py installed the wrong version of webhelpers. You must downgrade it.
$ sudo easy_install "webhelpers==0.6.4"
(OperationalError) FATAL: password authentication failed for user "reddit" The postgres user "reddit" has the wrong password. You should recreate the postgres user "reddit" with password "reddit".
reddit$ su postgres
postgres$ dropuser reddit
postgres$ createuser -P reddit
</td>

Other Questions

Do I need to use S3 to run reddit?

At the moment, S3 is required for thumbnails. We are willing to accept patches that would allow you to choose where to store them.

What is the administrator account?

By default, there are no accounts. Create an account and add it to the admins line in example.ini. If you populate the database using populatedb it will generate an account called reddit with password password which is in the list of admins by default.

Why can't I log in to my reddit?

Most browsers won't deal with cookies from a domain that doesn't contain dots. For example, http://localhost will not work, while http://reddit.local or http://127.0.0.1 will. Make sure you update the .ini file accordingly!

How do I create a subreddit?

By default, the link to the form for subreddit creation is hidden for accounts newer than 30 days. This was done because a large number of new users were confused about what creating a reddit meant and would use the form to try and post links. The form can be accessed at any time by going to /reddits/create. It's also possible to configure the minimum age an account must have to be able to see the link by tweaking the min_membership_create_community property. Setting this value to 0 will allow all users to see the link.

How do I make subreddits show up in the top bar?

update_reddits needs to be run. See Cron Jobs for more information on what this does. To run it manually:

sudo start reddit-job-update_reddits 

What if the top bar isn't showing up at all?

Check that domain in the ini file matches the domain that you're accessing your reddit clone with.

Why doesn't the "My Reddits" dropdown show up?

The dropdown is only rendered if the current user is subscribed to more than sr_dropdown_threshold subreddits (see example.ini.) The default threshold is 15 subreddits.

Why doesn't search work?

reddit used to use Solr for its search needs, but switched to using IndexTank in July 2010. The code for searching with Solr still exists in the repository, but is inactive. A third party running a reddit clone could either create a patch that reactivates Solr, or get an IndexTank account.

If you don't have INDEXTANK_API_URL in run.ini set to a valid URL, searching will fail with the following error.

<type 'exceptions.TypeError'>: unsupported operand type(s) for +: 'NoneType' and 'str'

To use IndexTank, you must create an index named "main" on IndexTank, or change the name of the index in /r2/r2/lib/indextank.py line 45 from "main" to your index's name.

Why doesn't subreddit search or the "related" tab work?

Solr is still used for subreddit search and the "related" tab. This is transitional until we convert completely to IndexTank. The install script does not currently install or configure Solr and so neither of these features will work until that is done.

Clone this wiki locally