Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Clone this wiki locally
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.
Automated Install Script for Ubuntu 12.04:
nc: connect to localhost port 9160 (tcp) failed: Connection refused
Cassandra has failed to start. On Ubuntu 12.04 using the automated installation script this is due to an inadequate stack size in OpenJDK for Cassandra. Confirm by running
cassandra -f. If you get
The stack size specified is too small, Specify at least 160k, then open
/etc/cassandra/cassandra-env.sh and modify Line 154 from
JVM_OPTS="$JVM_OPTS -Xss128k" to
JVM_OPTS="$JVM_OPTS -Xss160k" and
sudo /etc/init.d/cassandra start.
How can I figure out which part of the system is broken?
$ sudo tail -f /var/log/syslog
This is where all of the services' logs are sent and should give you a stack trace if something's breaking.
I'm seeing an error. What should I do?
|ImportError: No module named wrapped||
You need to compile the Cython modules.
$ cd ~/reddit/r2 $ make
|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
Do I need to use S3 to run reddit?
No, using Amazon S3 is optional. The default install executed by the install script uses a local nginx to host thumbnails and subreddit images. See the
media_provider option in the configuration and the
r2/lib/providers/media directory in the source.
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
inject_test_data.py it will generate an account called
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://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
/subreddits/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?
domain in the ini file matches the domain that you're accessing your reddit clone with.
Why doesn't the "My Subreddits" 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. They currently use Amazon CloudSearch. /u/kemitche and has provided instructions on how to set up a clone to use your own instance. There are more detailed instructions provided by /u/gianlucaneri