Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Fork of Etherpad Opensource application. With some fixes. Imports and Exports (with file conversion) patched.

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 etherpad
Octocat-spinner-32 infrastructure
Octocat-spinner-32 lib
Octocat-spinner-32 COPYING
Octocat-spinner-32 README
Octocat-spinner-32 README.md
Octocat-spinner-32 env.sh
Octocat-spinner-32 users-guide.md
README.md

Karteek's Etherpad Fork

Package

  • Etherpad source from Etherpad Google Code repository
  • Some minor fixes/changes here and there
  • Oo.org integration for file exports and file imports from DOC/RTF format
  • Commented code for File imports due to license restrictions

How to

  1. Grab the code from github $ git clone git://github.com/karteek/etherpad.git
  2. Set up the environment in env.sh and source the file. The settings inside are from my MBP. Do update them to meet your machine's settings. $ source env.sh
  3. Create a database "etherpad", add a user "etherpad" with password "password" on a MySQL database server. Grant all privileges for on database etherpad to etherpad@localhost
  4. Update etherpad.SQL_JDBC_URL, etherpad.SQL_USERNAME, etherpad.SQL_PASSWORD and etherpad.adminPass in the file "etherpad/etc/etherpad.localdev-default.properties"
  5. Change dir to etherpad, compile the jar and start the server $ cd etherpad $ bin/rebuildjar.sh $ bin/run-local.sh
  6. You are done. Visit http://localhost:9000 to check your instance

How to Enable File Imports

  1. File Imports depend on cos.jar - com.oreilly.servlet
  2. Do read the license
  3. Even now, if you want to continue with imports just apply this gist or
    • Download cos.jar from the site and copy it to infrastructure/lib folder
    • In infrastructure folder, find out the files, where imports functionality is commented $ grep -R "REMOVED_COS_OF_COS" *
    • Uncomment and recompile JAR

How to Enable Exports

  1. Make sure that there is a "etherpad.soffice" entry in the file "etherpad/etc/etherpad.localdev-default.properties"
  2. You need Openoffice.org to be running on your machine as service. It usually on linux is $ /path/to/openoffice/program/soffice.bin -headless -nofirststartwizard -accept="socket,host=localhost,port=8100;urp;StarOffice.Service"
  3. Check the file "infrastructure/com.etherpad.openofficeservice/importexport.scala" for more info

How to deploy the same on example.com

  1. Edit your dns and point *.example.com to the same server where example.com resides
  2. Make sure that your SMTP is working
  3. Open etherpad/src/main.js, and update domain in line #273
  4. Open etherpad/src/etherpad/globals.js and change the domain in variable SUPERDOMAINS found at line #30
  5. Open etherpad/src/static/crossdomain.xml and add your domain to crossdomains.xml
  6. Look into the src folder and update your domain where etherpad.com is used (especially emails) $ grep -ir "etherpad.com" * and update domain in all the files.
  7. Open etherpad/etc/etherpad.localdev-default.properties and update
    • devMode to false
    • etherpad.isProduction to true
    • listen to example.com:80 and change passwords too.
  8. Now start the server. You will need root access on OS X to bind to ports < 1000. $ bin/run-local.sh

How to do the same on example.com but with a reverse proxy on Apache

  1. Do steps 1 thru 7 in above. But dont update listen as told in 7, rather update listen to example.com:9000, and set hidePorts to true
  2. Create a vhost entry. It might look like this gist
  3. Restart apache, and things should work

Other applied patches

Something went wrong with that request. Please try again.