<commit_before>---
layout: book
section: documentation
category: installation
title: Upgrade notes
permalink: /docs/upgrade
---
## 0.6

### Application data directory on Ubuntu

On *Ubuntu*, TileMill files are now kept in `~/Documents/MapBox` by default. After starting TileMill for the first time the directory will be created. Move your projects and other data from their old location, such as `/usr/share/mapbox`, to the new directory.

### Execution changes on Ubuntu

TileMill now runs as the logged in user on Ubuntu. You may need to adjust file permissions and ownership on your data files to make them readable by TileMill.

## 0.4

### 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<commit_msg>Make it clear you can run TileMill from the desktop or as a service.<commit_after>---
layout: book
section: documentation
category: installation
title: Upgrade notes
permalink: /docs/upgrade
---
## 0.6

### Application data directory on Ubuntu

On *Ubuntu*, TileMill files are now kept in `~/Documents/MapBox` by default. You can start TileMill from the Applications menu or Launcher while logged in as a desktop user.  After starting TileMill for the first time the aforementioned directory will be created. You may move your projects and other data from their old location, such as `/usr/share/mapbox`, to the new directory.

### Execution changes on Ubuntu

TileMill can now be run as the logged in desktop user on Ubuntu. Look for the TileMill menu item in the Applications menu or Launcher. You may need to adjust file permissions and ownership on your data files to make them readable by TileMill if you decide to move your data from the previous directory (/usr/share/mapbox). You can stil run TileMill as a service using the `upstart` command, if so desired.

## 0.4

### 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
{'fraction_non_alphanumeric': 0.05873261205564142, 'fraction_numerical': 0.009891808346213293, 'mean_word_length': 4.10410094637224, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6417354', 'n_tokens_mistral': 935, 'n_tokens_neox': 864, 'n_words': 478}