<h1>Upgrading an existing installation<aclass="headerlink"href="#upgrading-an-existing-installation"title="Permalink to this headline">¶</a></h1>
<sectionid="evennia-v0-9-5-to-1-0">
<h2>Evennia v0.9.5 to 1.0<aclass="headerlink"href="#evennia-v0-9-5-to-1-0"title="Permalink to this headline">¶</a></h2>
<p>Prior to 1.0, all Evennia installs were <aclass="reference internal"href="Installation-Git.html"><spanclass="doc std std-doc">Git-installs</span></a>. These instructions
assume that you have a cloned <codeclass="docutils literal notranslate"><spanclass="pre">evennia</span></code> repo and use a virtualenv (best practices).</p>
<ulclass="simple">
<li><p>Make sure to stop Evennia 0.9.5 entirely with <codeclass="docutils literal notranslate"><spanclass="pre">evennia</span><spanclass="pre">stop</span></code>.</p></li>
<li><p><codeclass="docutils literal notranslate"><spanclass="pre">deactivate</span></code> to leave your active virtualenv.</p></li>
<li><p>Make a <em>backup</em> of your entire <codeclass="docutils literal notranslate"><spanclass="pre">mygame</span></code> folder, just to be sure!</p></li>
<li><p>Delete the old <codeclass="docutils literal notranslate"><spanclass="pre">evenv</span></code> folder, or rename it (in case you want to keep using 0.9.5 for a while).</p></li>
<li><p>Install Python 3.10 (recommended) or 3.9. Follow the <aclass="reference internal"href="Installation-Git.html"><spanclass="doc std std-doc">Git-installation</span></a> for your OS if needed.</p></li>
<li><p>If using virtualenv, make a <em>new</em> one with <codeclass="docutils literal notranslate"><spanclass="pre">python3.10</span><spanclass="pre">-m</span><spanclass="pre">venv</span><spanclass="pre">evenv</span></code>, then activate with <codeclass="docutils literal notranslate"><spanclass="pre">source</span><spanclass="pre">evenv/bin/activate</span></code>
(linux/mac) or <codeclass="docutils literal notranslate"><spanclass="pre">\evenv\Script\activate</span></code> (windows)</p></li>
<li><p><codeclass="docutils literal notranslate"><spanclass="pre">cd</span></code> into your <codeclass="docutils literal notranslate"><spanclass="pre">evennia/</span></code> folder (you want to see the <codeclass="docutils literal notranslate"><spanclass="pre">docs/</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">bin/</span></code> directories as well as a nested <codeclass="docutils literal notranslate"><spanclass="pre">evennia/</span></code> folder)</p></li>
<li><p><strong>Prior to 1.0 release only</strong> - do <codeclass="docutils literal notranslate"><spanclass="pre">git</span><spanclass="pre">checkout</span><spanclass="pre">develop</span></code> to switch to the develop branch. After release, this will
<li><p>If you want the optional extra libs, do <codeclass="docutils literal notranslate"><spanclass="pre">pip</span><spanclass="pre">install</span><spanclass="pre">-r</span><spanclass="pre">requirements_extra.txt</span></code>.</p></li>
<li><p>Test that you can run the <codeclass="docutils literal notranslate"><spanclass="pre">evennia</span></code> command.</p></li>
<p>If you don’t have anything you want to keep in your existing game dir, you can just start a new onew
using the normal <aclass="reference internal"href="Installation.html"><spanclass="doc std std-doc">install instructions</span></a>. If you want to keep/convert your existing
<li><p><codeclass="docutils literal notranslate"><spanclass="pre">cd</span></code> to your existing 0.9.5-based game folder (like <codeclass="docutils literal notranslate"><spanclass="pre">mygame</span></code>.)</p></li>
<li><p>If you have changed <codeclass="docutils literal notranslate"><spanclass="pre">mygame/web</span></code>, <em>rename</em> the folder to <codeclass="docutils literal notranslate"><spanclass="pre">web_0.9.5</span></code>. If you didn’t change anything (or don’t have
anything you want to keep), you can <em>delete</em> it entirely.</p></li>
<li><p>Copy <codeclass="docutils literal notranslate"><spanclass="pre">evennia/evennia/game_template/web</span></code> to <codeclass="docutils literal notranslate"><spanclass="pre">mygame/</span></code> (e.g. using <codeclass="docutils literal notranslate"><spanclass="pre">cp</span><spanclass="pre">-Rf</span></code> or a file manager). This new <codeclass="docutils literal notranslate"><spanclass="pre">web</span></code> folder
replaces the old one and has a very different structure.</p></li>
<p>If you made extensive work in your game dir, you may well find that you need to do some (hopefully minor)
changes to your code before it will start with Evennia 1.0. Some important points:</p>
<ulclass="simple">
<li><p>The <codeclass="docutils literal notranslate"><spanclass="pre">evennia/contrib/</span></code> folder changed structure - there are now categorized sub-folders, so you have to update
your imports.</p></li>
<li><p>Any <codeclass="docutils literal notranslate"><spanclass="pre">web</span></code> changes need to be moved back from your backup into the new structure of <codeclass="docutils literal notranslate"><spanclass="pre">web/</span></code> manually.</p></li>
<li><p>See the <aclass="reference internal"href="../Coding/Changelog.html"><spanclass="doc std std-doc">Evennia 1.0 Changelog</span></a> for all changes.</p></li>
