X-Git-Url: https://git.openstreetmap.org/rails.git/blobdiff_plain/f28e236bdd79d8e2b7e9c1186d92a1f7167825f6..c162c065c6f6db5dc584599f5639b296b627a165:/INSTALL.md diff --git a/INSTALL.md b/INSTALL.md index b1fb1eafb..097d4500e 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -24,14 +24,15 @@ of packages required before you can get the various gems installed. * Bundler * Javascript Runtime -These can be installed on Ubuntu 16.04 or later with: +These can be installed on Ubuntu 18.04 or later with: ``` -sudo apt-get install ruby2.5 libruby2.5 ruby2.5-dev \ +sudo apt-get update +sudo apt-get install ruby2.5 libruby2.5 ruby2.5-dev bundler \ libmagickwand-dev libxml2-dev libxslt1-dev nodejs \ apache2 apache2-dev build-essential git-core \ postgresql postgresql-contrib libpq-dev postgresql-server-dev-all \ - libsasl2-dev imagemagick libffi-dev + libsasl2-dev imagemagick libffi-dev libgd-dev libarchive-dev libbz2-dev sudo gem2.5 install bundler ``` @@ -42,11 +43,12 @@ sudo gem2.5 install bundler For Fedora, you can install the minimum requirements with: ``` -sudo yum install ruby ruby-devel rubygem-rdoc rubygem-bundler rubygems \ +sudo dnf install ruby ruby-devel rubygem-rdoc rubygem-bundler rubygems \ libxml2-devel js \ gcc gcc-c++ git \ postgresql postgresql-server postgresql-contrib postgresql-devel \ - perl-podlators ImageMagick libffi-devel + perl-podlators ImageMagick libffi-devel gd-devel libarchive-devel \ + bzip2-devel nodejs-yarn ``` If you didn't already have PostgreSQL installed then create a PostgreSQL instance and start the server: @@ -114,15 +116,22 @@ cd openstreetmap-website bundle install ``` -## Application setup +## Node.js modules -We need to create the `config/application.yml` file from the example template. This contains various configuration options. +We use [Yarn](https://yarnpkg.com/) to manage the Node.js modules required for the project. ``` -cp config/example.application.yml config/application.yml +bundle exec rake yarn:install ``` -You can customize your installation of The Rails Port by changing the values in `config/application.yml` +## Storage setup + +The Rails port needs to be configured with an object storage facility - for +development and testing purposes you can use the example configuration: + +``` +cp config/example.storage.yml config/storage.yml +``` ## Database setup @@ -209,7 +218,7 @@ Rails comes with a built-in webserver, so that you can test on your own machine bundle exec rails server ``` -You can now view the site in your favourite web-browser at `http://localhost:3000/` +You can now view the site in your favourite web-browser at [http://localhost:3000/](http://localhost:3000/) Note that the OSM map tiles you see aren't created from your local database - they are just the standard map tiles.