From OpenStreetMap Wiki
Jump to: navigation, search
Available languages —
· Afrikaans · Alemannisch · aragonés · asturianu · azərbaycanca · Bahasa Indonesia · Bahasa Melayu · Bân-lâm-gú · Basa Jawa · Basa Sunda · Baso Minangkabau · bosanski · brezhoneg · català · čeština · corsu · dansk · Deutsch · eesti · English · español · Esperanto · estremeñu · euskara · français · Frysk · Gaeilge · Gàidhlig · galego · Hausa · hrvatski · Igbo · interlingua · Interlingue · isiXhosa · isiZulu · íslenska · italiano · Kiswahili · Kreyòl ayisyen · kréyòl gwadloupéyen · Kurdî · latviešu · Lëtzebuergesch · lietuvių · magyar · Malagasy · Malti · Nederlands · Nedersaksies · norsk bokmål · norsk nynorsk · occitan · Oromoo · oʻzbekcha/ўзбекча · Plattdüütsch · polski · português · română · shqip · slovenčina · slovenščina · Soomaaliga · suomi · svenska · Tagalog · Tiếng Việt · Türkçe · Vahcuengh · vèneto · Wolof · Yorùbá · Zazaki · српски / srpski · беларуская · български · қазақша · македонски · монгол · русский · тоҷикӣ · українська · Ελληνικά · Հայերեն · ქართული · नेपाली · मराठी · हिन्दी · भोजपुरी · অসমীয়া · বাংলা · ਪੰਜਾਬੀ · ગુજરાતી · ଓଡ଼ିଆ · தமிழ் · తెలుగు · ಕನ್ನಡ · മലയാളം · සිංහල · བོད་ཡིག · ไทย · မြန်မာဘာသာ · ລາວ · ភាសាខ្មែរ · ⵜⴰⵎⴰⵣⵉⵖⵜ ⵜⴰⵏⴰⵡⴰⵢⵜ‎ · አማርኛ · 한국어 · 日本語 · 中文(简体)‎ · 中文(繁體)‎ · 吴语 · 粵語 · ייִדיש · עברית · اردو · العربية · پښتو · سنڌي · فارسی · ދިވެހިބަސް

New installation guide by g0ldfish

Debian Squeeze (minimal installation, only standard system tools)

Login as root

For CPAN configuration: Debian packages sudo, build-essential

$ apt-get install sudo build-essential

Use visudo to grant sudo rights, e.g. full sudo rights for group:

$ visudo

Add new line containing

%groupname ALL=(ALL) ALL

save with Ctrl-o, quit visudo with Ctrl-x

Login as user

Set up CPAN to use as non-root user: Start CPAN, let it configure automatically, then choose appropriate download servers. After that change make_install_make_command and mbuild_install_build_command manually so that the commands are executed with sudo.

$ cpan
cpan [x]> o conf make_install_make_command 'sudo /usr/bin/make'
cpan [x]> o conf mbuild_install_build_command 'sudo ./Build'
cpan [x]> o conf commit

(see also


cpan [x]> q

Use local::lib to create module tree in home directory (version # may differ)

$ wget
$ tar xfz local-lib-1.008004.tar.gz
$ cd local-lib-1.008004/
$ perl Makefile.PL --bootstrap=~/.perl
$ make test && sudo make install
$ echo 'eval $(perl -I$HOME/.perl/lib/perl5 -Mlocal::lib=$HOME/.perl)' >> ~/.bashrc

(see also [1])

Login in again

For Mapgen: Debian packages: libcompress-bzip2-perl, libgd-graph3d-perl, proj

$ sudo apt-get install libcompress-bzip2-perl libgd-graph3d-perl proj
$ cpan
cpan [x]> install Math::Polygon 
cpan [x]> install Geo::Proj4 
cpan [x]> install DBI
cpan [x]> install LWP::Simple

Old information gathered by many users

Easiest way is to set up SVN access!

  • HINT: the *.pm files go into a subfolder "OSM"
  • Math::Polygon can be obtained from CPAN
  • GD installation: sudo apt-get install libgd-graph3d-perl
  • bzip2 installation: sudo apt-get install libcompress-bzip2-perl
  • Geo::Proj4: (not working on Windows!)
    • sudo apt-get install proj
    • sudo apt-get install proj-data
    • cpan<enter>, then install Geo::Proj4
      • May result in error (No makefile found)
      • cd ~/.cpan/build/Geo-Proj4*
      • perl Makefile.PL
      • make && make test && make install

Following programs only needed if directory PDFs will be created

  • latex:sudo apt-get install texlive-latex-base
  • dvips: sudo apt-get install texlive-latex-bin
  • ps2pdf: sudo apt-get install texlive-latex-bin


Topo Style

Install on GNU/Linux

Download the files above and

  • Put the file in a folder
  • Put and mapgenRules.csv in the same folder
  • Make a subfolder called OSM and put all *.pm files there (can also be put into a directory contained in the @INC pathes)
  • Make a subfolder called Math (can also be put into a directory contained in the @INC pathes)

Use the Perl cpan software to download additional modules needed:

  • Start a terminal and type cpan <Enter> (better sudo cpan ???)
  • If this is the first time running cpan, follow instructions to configure it
  • When configuration is done there should be a cpan[x]> prompt visible and waiting for commands
  • Write get Math::Polygon to install the Polygon module (better install instead of get???)
  • Write get Geo::Proj4 to install the Proj4 module (better install ???)
  • Write q to quit the cpan software

Check that BZ2 and GD support is installed on your computer:

  • For bzip2 installation run sudo apt-­get install libcompress­-bzip2-­perl
  • For GD installation run sudo apt-­get install libgd-­graph3d­-perl

Now there are some optional software needed depending on what you want to do.

  • If you want to use only a part of an OSM-file, you need to install osmosis. Take care that it can be invoked from command line
  • If you are using SVG files as tile patterns or when converting from SVG to PNG or PDF, you need to install inkscape by running sudo apt-get install inkscape. Take care that it can be invoked from command line

If you want to have the Street directory in PDF format, you'll also need the following:

  • latex: sudo ap-t­get install texlive-­latex­-base
  • dvips: sudo apt-­get install texlive­-base
  • ps2pdf: sudo apt-­get install texlive­-recommended