diff --git a/Upgrade-to-Ubuntu-18.04.md b/Upgrade-to-Ubuntu-18.04.md
new file mode 100644
index 0000000..526af61
--- /dev/null
+++ b/Upgrade-to-Ubuntu-18.04.md
@@ -0,0 +1,55 @@
+## Upgrade to Ubuntu 16.04
+
+notes on upgrading unbuntu from 16.04 to 18.04 for pan.do/ra
+
+    apt-get install ubuntu-release-upgrader-core
+    do-release-upgrade
+
+Questions:
+- Do you want to upgrade glibc now? YES
+- Restart services during package upgrades without asking? YES
+- Keep /etc/nginx/nginx.conf and /etc/nginx/sites-available/default
+- install the package maintainer's version /etc/postgresql-common/createcluster.conf
+
+restart
+
+Post Upgrade:
+
+Install systemd service files and remove upstart scripts:
+
+
+    rm /etc/init/pandora*
+    /srv/pandora/ctl install
+
+possibly adjust settings in /srv/pandora/pandora/gunicorn_config.py
+
+Stop all pan.do/ra processes (run as root):
+
+    /srv/pandora/ctl stop
+
+Enable pan.do/ra PPA again (run as root):
+
+    sed -i "s/^# deb/deb/g" /etc/apt/sources.list.d/j*.list
+    apt update; apt upgrade; apt autoremove; apt clean
+
+New version of Postgres requires database migration (run as root):
+
+    apt install postgresql-10 postgresql-contrib-10 postgresql-client-10
+
+    pg_dropcluster 10 main --stop
+    pg_upgradecluster 9.5 main
+    pg_dropcluster 9.5 main
+
+    apt remove postgresql-9.5 postgresql-contrib-9.5 postgresql-client-9.5
+    systemctl restart postgresql
+    
+
+Upgrade virtualenv (run this as "pandora" user):
+
+    cd /srv/pandora
+    rm -r bin lib share
+    ./ctl init
+
+Start pan.do/ra again (run as root):
+
+    /srv/pandora/ctl start
\ No newline at end of file