diff --git a/pages/wiki/documentation.hbs b/pages/wiki/documentation.hbs
index b566e50..f869bfd 100644
--- a/pages/wiki/documentation.hbs
+++ b/pages/wiki/documentation.hbs
@@ -11,6 +11,7 @@ layout: documentation
   <li><a href="{{rel 'wiki/porting-status'}}">Porting Status</a></li>
   <li><a href="{{rel 'wiki/ssh'}}">SSH</a></li>
   <li><a href="{{rel 'wiki/useful-commands'}}">Useful commands</a></li>
+  <li><a href="{{rel 'wiki/update-asteroidos'}}">Update AsteroidOS</a></li>
   <li><a href="{{rel 'wiki/bluetooth'}}">Bluetooth</a></li>
   <li><a href="{{rel 'wiki/translating-asteroidos'}}">Translating AsteroidOS</a></li>
   <li><a href="{{rel 'wiki/licenses'}}">Licenses</a></li>
diff --git a/pages/wiki/update-asteroidos.hbs b/pages/wiki/update-asteroidos.hbs
new file mode 100644
index 0000000..fd502c7
--- /dev/null
+++ b/pages/wiki/update-asteroidos.hbs
@@ -0,0 +1,32 @@
+---
+title: Update AsteroidOS
+layout: documentation
+---
+
+<p>AsteroidOS currently doesn't offer any nice OTA experience. The main limitation being the connectivity of watches. AsteroidOS watches don't have direct access to the Internet which is very limitating when it comes to upgrades. This page tries to document how to upgrade Asteroid.</p>
+
+<div class="page-header">
+  <h1 id="reflash">Reflash AsteroidOS</h1>
+</div>
+
+<p>The easiest way, as of today, is just to reflash the entire OS following the usual <a href="https://asteroidos.org/install/">installation instructions</a>.</p>
+
+<div class="page-header">
+  <h1 id="opkg-usb">OPKG over USB</h1>
+</div>
+
+<p>If you don't want to loose your personal data and would prefer upgrading Asteroid without reflashing it you can use asteroid's package manager: opkg. However, your watch most likely lacks Internet connectivity so you'll need to connect your watch to the Internet somehow. The following instructions describe how to share your computer's connectivity with your watch.</p>
+
+<p>Configure a NAT <b>on your computer</b> (note: replace eth0 with the name of the interface that connects your computer to the Internet) with:</p>
+<pre><code>echo 1 > /proc/sys/net/ipv4/ip_forward
+iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE</code></pre>
+
+<p>Configure a default gateway and DNS <b>on the watch</b> with the following commands ran via <a href="https://asteroidos.org/wiki/ssh/">SSH</a>:</p>
+
+<pre><code>route add default gw 192.168.2.1
+echo "nameserver 8.8.8.8" >> /etc/resolv.conf</code></pre>
+
+<p>You can now upgrade your distribution with opkg using the standard commands:</p>
+
+<pre><code>opkg update
+opkg ugrade</code></pre>