Skip to content
Switch branches/tags


Image of Saidit logo

SaidIt is a reddit open source continuation and fork with:

  • critical configurations restored
  • critical bug fixes
  • admin user bans and ip bans
  • configurable site branding
  • configurable home page
  • enhanced expandos/embeds: more media providers, direct media links, used in comments, sidebars and wiki pages

SaidIt customizations include:

  • two dimensional voting where insightful is +2 and fun is +1
  • public moderator logs
  • chat integration with a custom TheLounge web IRC client


  • easily setup your own saidit/reddit open source clone
  • platform upgrades, longevity
  • enhancements and quality of life improvements
  • reddit API compatibility


There are two ways to set up a saidit server: on a standalone physical server, or through a Virtual Machine environment (running within another OS such as linux, MacOS, or Windows) for development and testing purposes.

Setting up a virtual machine

  1. Download and install VirtualBox
  2. Download the latest Ubuntu 14.04 server .iso file "64-bit PC (AMD64) server install image"
  3. Start VirtualBox and click 'New'
    1. Type: Linux
    2. Version: Ubuntu (64-bit)
    3. Memory Size: 4000 MB (minimum)
    4. File location and size: 30.0 GB (minimim)
  4. Right click the new VM and choose 'Settings'
    1. Network: Adapter 1: Attached to: "Bridged Adapter"
    2. Storage: select the empty CD icon and click "Choose Virtual Optical Disk File" and choose the ubuntu server .iso file
  5. Select the new VM and click 'Start'
  6. Install Ubuntu and choose following options, but leaving all other options with the default selection:
    1. Username: reddit
    2. Choose software to install: select OpenSSH, but no others
  7. Complete Ubuntu installation

From this point forward you can start your VM with Start -> Headless Start and connect via ssh as user 'reddit' if you wish, using a program like PuTTY. Don't forget to shut down your VM by right clicking it and choosing Close -> ACPI Shutdown before shutting down your host OS or you may corrupt your VM.

Setting up a physical server

  1. Download the latest Ubuntu 14.04 server .ISO file "64-bit PC (AMD64) server install image"
  2. Download Rufus (as recommended by Ubuntu) and use it to write the .ISO to a USB drive
  3. Once finished, put the USB drive in the server and boot to it
  4. Install Ubuntu with the following options, but leaving all other options with the default selection:
    1. Username: reddit
    2. Choose software to install: select OpenSSH, but no others
  5. When install finishes, remove USB drive and boot to linux

From this point forward physical access to the server is no longer needed and you can ssh in as the 'reddit' user remotely if you wish, using a program like PuTTY.

Configure DNS for reddit.local

To use your reddit server, you are expected to be able to resolve reddit.local and https://reddit.local. First, find the ip address of your saidit server by running:

$ ifconfig
# note the 'inet addr' for device 'eth0' or similar

Then update your hosts file on your development machine/host OS. For example, on linux with saidit server ip run:

$ sudo sed -i '1i reddit.local' /etc/hosts

For Windows and MacOS see

Install SaidIt

SSH into your saidit server

$ ssh reddit@reddit.local

Install SaidIt

$ wget
$ chmod +x
$ sudo ./

You should see success message "Congratulations! reddit is now installed." Do not proceed if the installation failed with an error.

Visit https://reddit.local and create accounts for users 'reddit' and 'automoderator'. Alternatively, you can install some default/sample data including users 'reddit' and 'automoderator' (with password 'password'), subs, posts, and comments with:

$ reddit-run ~/src/reddit/scripts/ -c 'inject_test_data()'

SaidIt is now fully functional aside from search and optional chat. The SaidIt Admin Guide has instructions for changing your site configuration.

Install search

SaidIt comes pre-configured for Solr search, but Solr and Tomcat are not installed yet.

Install Solr

$ cd ~
$ sudo apt-get install tomcat7 tomcat7-admin software-properties-common
$ wget
$ tar -xvzf solr-4.10.4.tgz
$ sudo mv solr-4.10.4 /usr/share/solr
$ sudo chown -R tomcat7:tomcat7 /usr/share/solr/example

Setup Solr, install Reddit schema

$ sudo cp /usr/share/solr/example/webapps/solr.war /usr/share/solr/example/solr/
$ sudo cp /usr/share/solr/example/lib/ext/* /usr/share/tomcat7/lib/
$ sudo cp /usr/share/solr/example/resources/ /usr/share/tomcat7/lib/
$ sudo cp src/reddit/solr/schema4.xml /usr/share/solr/example/solr/collection1/conf/schema.xml
$ sudo chown tomcat7:tomcat7 /usr/share/solr/example/solr/collection1/conf/schema.xml

Setup Tomcat for Solr

$ sudo nano /usr/share/tomcat7/lib/
# edit to set:

$ sudo nano /etc/tomcat7/Catalina/localhost/solr.xml
# add content:
<Context docBase="/usr/share/solr/example/solr/solr.war" debug="0" crossContext="true">
  <Environment name="solr/home" type="java.lang.String" value="/usr/share/solr/example/solr" override="true" />

# have tomcat use port 8983 ('solr_port' in example.ini), port 8080 is haproxy
sudo nano /etc/tomcat7/server.xml
# edit to set:
<Connector port="8983" protocol="HTTP/1.1"

# Solr is missing some required stuff:
$ sudo touch /usr/share/solr/solr.log
$ sudo mkdir /usr/share/tomcat7/temp
$ sudo chown tomcat7:tomcat7 /usr/share/solr/solr.log
$ sudo chown tomcat7:tomcat7 /usr/share/tomcat7/temp

# verify tomcat all good (ignore warnings):
$ /usr/share/tomcat7/bin/

Start solr:

$ sudo service tomcat7 restart
# any errors logged must be fixed
$ sudo cat /var/log/tomcat7/catalina.out
# verify working, these should return html pages:
$ wget
$ wget

Index site content and test:

$ sudo start reddit-job-solr_subreddits
$ sudo start reddit-job-solr_links
# do a search on the site, verify working

Next steps

See also


The reddit open source fork powering SaidIt




No releases published

Sponsor this project


No packages published