# Upgrade notes ## 0.4.x ### Important note for Ubuntu users A specific version of mapnik2 is provided in the `mapbox` PPA for use with TileMill 0.4.x. TileMill will not work if you have **any other version** of mapnik2 installed on your system. Please remove any previous versions of mapnik2 that you may have installed from source or from the mapnik `nightly-trunk` PPA. **Removing mapnik2 compiled from source** Enter the directory of the original mapnik2 source. cd /home/ubuntu/mapnik2 # or the path to your mapnik2 source sudo make uninstall **Removing mapnik2 from the nightly-trunk PPA** First remove your mapnik2 packages. sudo apt-get uninstall mapnik2* Remove the `sources.list` entries for the `nightly-trunk` PPA and run sudo apt-get update You can now install TileMill using the `install-tilemill.sh` script. ### Project files TileMill on *Mac OS X* now keeps its files in your user's home directory at `~/Documents/MapBox`. On *Ubuntu*, TileMill files are kept in `/usr/share/mapbox`. After starting TileMill for the first time the directory will be created. Move your projects from their old location to the new `project` directory. ### Relative paths If you bravely used relative paths to reference markers and other images in your old Carto stylesheets you need to update the paths to be relative to your project's directory. For example the following rule which worked in TileMill 0.3.x by virtue of being relative to the Mapnik XML file written into the hidden `.cache` directory polygon-pattern-file: url(../project/new-world/res/land.png); Should be changed to be relative to the project directory polygon-pattern-file: url(res/land.png); ### Minimal mode A setting for entering and leaving minimal mode no longer exists. Projects will automatically update if you decide to edit their `mml` and `mss` files directly with another text editor. Beware that altering projects in both the TileMill UI and your editor is not recommended - TileMill will always give preference to an external editor if changes are made.