Assembla DocumentationPublic Space

This page contains required steps to import your local trac instance to Assembla integrated tickets tool. Check our tickets tool tour page to see what features our integrated ticket tool has

The easy way

After your Trac tickets are on Assembla, go to the Trac/SVN tab, and scroll to the bottom, and select the "Import" button.  Your tickets will be imported offline.  This can take up to 15 minutes.

If you have not already imported your Trac database to Assembla, then we need to upload your Trac database.  Go to your Trac and log in as a space owner. You will see an Admin tab on the top right. Select Admin, and select “Data Import/Export” from the left menu.  Select Trac Import and upload your zipped trac directory.

The hard way - run the import script from your own workstation

Let's begin:

1. Create your project space, if you do not have one.
2. Invite trac users to Assembla, you will find the invite form on space Team tab.
3. Add tickets and milestones tools: space Admin tab, Tools sub tab.
4. Download our ruby import script and save it as trac2assembla.rb
5. You should install these gems that script use: gem install mime-types sqlite3-ruby xml-simple
6. Open file in your favorite text editor and update config variables: your user name, password, space_URL, local path to your trac folder. You might also want to enter some lines for USER_MAP, these parameters will be used to map your trac user names to Assembla user names. If import script will not find a user in your space team list, it will use anonymous user to record ticket modifications
7. Run script with command: ruby trac2assembla.rb
8. Take a cup of tea or coffee and watch the output :-)

Note1: If something wrong happened you can start the script again, but you need to modify :trac_ticket_start parameter to instruct script from which ticket number to start import again.

Note2: If you want to start the import from the beginning, you should remove your ticket tool and add it again.

trac2assembla.rb script is a great help for developers who want to use our API. Read our API documentation