Skip to content

Workspaces JOSM Settings Guide

Connect JOSM to Workspaces⚓︎

This guide explains how to use the Workspaces JOSM Settings Script from TDEI Tools to set up JOSM to enable editing of Workspaces.

For a list of all guides on the TCAT Wiki, refer to the Guides List.

Instructions⚓︎

Note: You must have a TDEI Portal account.

1. Download and run the helper script⚓︎

  1. Download the Workspaces JOSM Settings Script from TDEI Tools.
  2. Run the script by right clicking and selecting "Run with PowerShell"

Now, follow the script's instructions and enter the requested information:

2. Determine your environment⚓︎

  1. Prod: portal.tdei.us + workspaces.sidewalks.washington.edu

  2. Stage: portal-stage.tdei.us + workspaces-stage.sidewalks.washington.edu

  3. Dev: portal-dev.tdei.us + workspaces-dev.sidewalks.washington.edu

3. Enter your TDEI credentials⚓︎

Enter the credentials for the account you use to sign into both the TDEI Portal and Workspaces.

4. Find your Workspace ID⚓︎

Extract the ID from the Workspace link, in this case 125:

https://workspaces.sidewalks.washington.edu/workspace/125/settings

5. Generate JOSM Settings⚓︎

After entering the Workspace ID, the script will authenticate you and output two strings.

6. Apply JOSM Settings⚓︎

  1. Open JOSM's "Preferences" Menu
  2. Navigate to the "OSM Server" menu
  3. If present, click "Remove token"
  4. Uncheck "Use the default OSM server URL"
  5. Paste in the generated URL from the script
  6. Select "Use Basic Authentication"
  7. Paste in the generated Access Token in the "OSM username" field
  8. Enter none in the "OSM password" field
  9. Save your settings changes.

You should now be able to use JOSM to edit the specified Workspace!