X-Git-Url: https://git.openstreetmap.org/rails.git/blobdiff_plain/ff7ddb6b86bf918a9418af7382836b41594d45e4..4b4217b8bece8cc24a2c973d3d7e492bf1b114ea:/CONFIGURE.md diff --git a/CONFIGURE.md b/CONFIGURE.md index 598ea3f65..96aac9f96 100644 --- a/CONFIGURE.md +++ b/CONFIGURE.md @@ -8,7 +8,7 @@ Many settings are available in `config/settings.yml`. You can customize your ins ## Populating the database -Your installation comes with no geographic data loaded. You can either create new data using one of the editors (Potlatch 2, iD, JOSM etc) or by loading an OSM extract. +Your installation comes with no geographic data loaded. You can either create new data using one of the editors (iD, JOSM etc) or by loading an OSM extract. After installing but before creating any users or data, import an extract with [Osmosis](https://wiki.openstreetmap.org/wiki/Osmosis) and the [``--write-apidb``](https://wiki.openstreetmap.org/wiki/Osmosis/Detailed_Usage#--write-apidb_.28--wd.29) task. @@ -58,11 +58,10 @@ $ bundle exec rails console Three of the built-in applications communicate via the API, and therefore need OAuth consumer keys configured. These are: -* Potlatch 2 * iD * The website itself (for the Notes functionality) -For example, to use the Potlatch 2 editor you need to register it as an OAuth application. +For example, to use the iD editor you need to register it as an OAuth application. Do the following: * Log into your Rails Port instance - e.g. http://localhost:3000 @@ -70,25 +69,25 @@ Do the following: * Click on "my settings" on the user page * Click on "oauth settings" on the My settings page * Click on 'Register your application'. -* Unless you have set up alternatives, use Name: "Local Potlatch" and URL: "http://localhost:3000" +* Unless you have set up alternatives, use Name: "Local iD" and URL: "http://localhost:3000" * Check the 'modify the map' box. * Everything else can be left with the default blank values. * Click the "Register" button * On the next page, copy the "consumer key" * Edit config/settings.local.yml in your rails tree -* Add the "potlatch2_key" configuration key and the consumer key as the value +* Add the "id_key" configuration key and the consumer key as the value * Restart your rails server An example excerpt from settings.local.yml: ``` # Default editor -default_editor: "potlatch2" -# OAuth consumer key for Potlatch 2 -potlatch2_key: "8lFmZPsagHV4l3rkAHq0hWY5vV3Ctl3oEFY1aXth" +default_editor: "id" +# OAuth consumer key for iD +id_key: "8lFmZPsagHV4l3rkAHq0hWY5vV3Ctl3oEFY1aXth" ``` -Follow the same process for registering and configuring iD (`id_key`) and the website/Notes (`oauth_key`), or to save time, simply reuse the same consumer key for each. +Follow the same process for registering and configuring the website/Notes (`oauth_key`), or to save time, simply reuse the same consumer key for each. ## Troubleshooting