Clone wiki

etherpad-win / Home

Read me instructions

Step 1:

Read carefully the official installing instructions:

Step 2:

Check the file rights we encountered problems on a windows 7 box with enabled UAC. We recommend windows XP with admin/write rights.

Step 3:


I would recommend to install all programs in a path which contains no spaces.

If you want to install everything in your "Program Files" or any other folder with spaces, you can use one of the following tricks:

Windows environment variables:

Make sure under "Control Panel->System->Advanced->Environment Variables" to setup your path correctly with all of the following:

  • C:\YourPathTo\Java\jdk1.6.0_18\bin
  • C:\YourPathTo\Scala\bin
  • C:\YourPathTo\MySQL\MySQL Server 5.1\bin
  • C:\YourPathTo\mysql-connector-java-5.1.10-bin.jar

Replace your YourPathTo with the actual path on your machine.

Pull the adjusted source with mercurial from here.

Step 4: Fire up the cygwin shell from the startmenu Set up the following Export pathes

export JAVA_HOME="C:\YourPathTo\Java\jdk1.6.0_18"
export SCALA_HOME="C:\YourPathTo\scala"
export JAVA="C:\YourPathTo\Java\jdk1.6.0_18\bin\java"
export SCALA="C:\YourPathTo\scala\bin\scala"
export MYSQL_CONNECTOR_JAR="C:\YourPathTo\mysql-connector-java-5.1.10-bin.jar"

Replace your YourPathTo with the actual path on your machine.

Step 5: Setup mysql database

  1. create the etherpad mysql db and privelidges
mysql -u root -p
  1. enter your password when prompted
create database etherpad;
grant all privileges on etherpad.* to 'etherpad'@'localhost' identified by 'password';


Step 6: Navigate to YourEtherpadPath/trunk/etherpad and run


If you encounter a cp error open C:\YourEtherpadPath\trunk\infrastructure\bin\

try these lines:


instead of:

	cp `cygpath -u "${MYSQL_CONNECTOR_JAR}"` lib/

After a successful run, you can start (make sure to adjust the parameters, like mysql password in the \trunk\etherpad\etc\


As an alternative you can use the run-local.bat in the trunk/etherpad folder and start etherpad without cygwin.


Finally I want to thank Jutsi, mad props for your excellent work to adjust all the paths in the source whenever needed and I also want to thank JohnMcLear for support and motivation.

I intend to put up a repository under This repository should contain a fixed package usable out of the box. Perhaps we can also create a version with batch files, that compiles without the cygwin shell.

Jutsi is working on the integration that etherpad supports Microsoft SQL Server (MSSQL) as database.