e107help.org Q&A
0 like 0 dislike
I have downloaded the e107_v1.x_to_2.0_upgrade.zip and the read me says to run the install.php

There is no install.php and prevoise upgrades I have just copied the new version ontop of my old version.

What is the procedure to upgrade?

e107 version 1.0.4
in Updating by (7 points) 1 1 1

1 Answer

0 like 0 dislike
Best answer

Dismiss the readme, you have done the correct thing already: 

basic steps would be:  backup first always best incl. dbase,

BEWARE : alpha state !

overwrite the existing files on server,

(.#dbase if possible before applying the update if not done yet)

change for v1 to v2 afterwards the e107_ht acces file to dot-htaccess ( .ht.....)

go into admin/tools/database if entering admin not already mentions : update, run chmod etc..)

possibility you will need to update plugins first to run through the upd.process

BEWARE : (at this point in time) alpha state ! errors could be present (v2 forum has some issues which are being addressed )

by (3.4k points) 8 9 11
selected by

1) Backup your website (including the database)

2) Download the v2 files (I actually recommend using the ones from Github but the v1 to v2 alpha2 package will work as well)

3) Unzip the v2 files and copy them over the v1 files. Be sure to overwrite all the existing files.

4) Go into the admin area and it will tell you there are database updates. Hit the button and then it should bring you to the database updates page.

5) Done. Test and report issues on Github please!: )

Is there reason why don't copy V1 (backup) to localhost, run upgrade there, then delete old site and move new V2 from localhost there?  Don't you know if somebody tested upgrade with with auth_alt plugin (V1 site with this plugin)? I want to help you to test upgrade process, but I am not still sure about it.

It is possible as described by you Jimako, end effect is identical (lesser labour).

But (always is), in case of errors the original stays intact because it is not touched yet.

(more secure, more work).

As for sites with auth_alt in use ????? Q for Github?
Thanks. I prefer localhost to exlude enviroment issues. I will upgrade only for testing purposes, so I propably do it on localhost at first, then the same on web. This is little site, but use no e107 auth, but auth_alt (users from php_nuke site).  I agree with this:  "in case of errors the original stays intact because it is not touched yet."  I missed probably something in your steps. You do the upgrade on original site, your backup is intact, or not? Thanks
Currently I do test upgrades on localhost as well, helps to find environmental related bugs at the same time! :)

 As for auth_alt, this stilll requires lots of testing Jana. Not even sure if it's functional now. Feel free to try it out, and post anything that breaks up on Github. Thanks!
Upgrade on original site : if error occurs (and no backups), i am stuck..
If upgrade on local : original (live) is still running, on local i might have error|
Restarting from fresh at local... just workload, and i can try again..

When upgrading does any database need upgrading i.e i have  downloaded db as per Mocs instructions above what do i do with this? or is this just in case things go wrong and i need to revert? also when i go to download e107 1.x to 2.0 alpha2 Upgrade (.zip) † it seems be the same as e107 1.0.4 Full install (.zip) i want to give v2 a try now ive cleaned up our site some what but dont want to lose all the content on our current v1.0.4 site hope this makes sense.

p.s clicking

e107 1.x to 2.0 alpha2 Upgrade (.zip)


takes me to http://sourceforge.net/projects/e107/?source=typ_redirect

which seems to be e107 v1.0.4

Do not upgrade your live website yet. The backup is there in case you need to revert (be sure to have both a backup of the files (through FTP) AS WELL AS a backup of your MySQL database (through phpmyadmin for example). 

I would strongly recommend to setup a copy of your website (locally perhaps, not live online) and then upgrade to v2 on that installation. At this point, v2 is not stable enough to use on a live website. There are still bugs and issues with it, it's still in the alpha development stage. 

I strongly recommend using the latest file from Github: https://github.com/e107inc/e107/archive/master.zip

 Alternatively you could use this download, which is the alpha2 package, compiled on the 8th of June 2014 (it does not contain the most recent fixes of these past months): https://github.com/e107inc/e107/releases

Hi, I know this is an old thread, but I am upgrading my site from 1.04 to 2.3. I'd really like some help on how to do that. All of the site's designers long ago left and I kind of inherited it. I realize I badly need to update it, as recently the site borked due to an old script and our web host had to roll it back for us. Any advice that can be offered is greatly appreciated. Thank you.
Hi Windthin,

The basic steps still apply.

1) Make sure you are on v1.0.4.
2) Create backups of both the files as well as the database.
3) Get rid of any old themes or plugins you are not using anymore (this minimises the risk of any issues)
4) Download the v1.0.4 to v2.3.0 upgrade files: https://e107.org/download
5) Overwrite your current v1.0.4 files with the files from the upgrade package.
6) Go directly into the Admin Area (navigate to yourwebsite.com/e107_admin/admin.php) and you should see a message for database updates. Complete those first until are database updates are completed.

Let us know if you have any questions or issues.
You should let here link to your site. The best way is to be on the gitter when you do this.  If any troubles, there are people who can help you.

I would prepare the list of actively used plugins f.e. forum, calendar, etc...  and check them.

Sometimes is better to create a new installation and import old content there...
The gitter? Where is that and how do I do that? Is this going to overwrite all of our current settings and everything then?


Okay, figured out how to get onto Gitter after a few searches.
Also, thank you both for the advice, it's much appreciated. This site's been running a good long while and I try to keep it maintained the best I can.
Here is our site, an RPG site: http://wodcityofangels.com/news.php


How hard would it be to swap everything to a new one? I admit to being nervous about doing it wrong. Most of what I know about running the back end of the site is self-taught.
If there are not plugins just for members, the only risk is forum and calendar plugins. What will be your new PHP version? Can it be 7.2 or you need to go higher?

You should ask for real help. I know you asked here, but this is just a discussion...  I mean - find someone who gets FTP and access to the database. I know that CaMeRon is helping with the update of old sites, there are others too, Moc, tglje.  If they reject, you can ask me. My opinion is that it is not a good idea to do this yourself if you don't know how to fix some stuff that always happens. Even you have the capabilities to do this, you should have somebody "on the line" to help you asap.  Don't forget time zones too.

Is it possible to copy the site to a subdirectory and run the update there? You will need to fix the theme too. Later, your actual one should work on PHP 7.2.

There is not only one way how to do this. I can say that each update is unique... But what is important, stick to one adviser. For example, my opinions are slightly different than official ones, so this is the reason why I told you to ask core developers on gitter at first and get their help.

Mainly, don't worry, this is for example site that looks almost identically to yours before update: https://urbangamers.dk/
As mentioned by others, calendar and forum (seems to be most prominent on site) will have things to look into but overall at first glance not to difficult.
This is based on what i see, not what happens inside.
If  wysiwig (tiny) was used when creating pages etc.. this could throw off the actual content settings.
Calendar less prominent it seems, so suppose you loose function on it? would that be ok?
Forum is present, so that is the one ( pages and members of course too ) are the ones to focus on.

Of course theme...is something different. There's a 3 column piece (colors of course and bg) RideBlue from
our Jimako that poses the overall appearance, else i would suggest plain bootstrap 3. (just some ideas).

Question becomes.. iff your not in a hurry i could look at it, and iff you want to do it yourself i can give pointers.
Personally (if i think a noticed correctly what happens on site), the best outcome would give a fresh install, and manually populate the tables out of the old ones..(carefully).
Depending of how the pages were created, it could mean a lot of work correcting placements of text and images..(helas iff so, but it is present). You always may contact me via PM (click user).

@Jimako : yes php 7 and onwards would be the case i guess, but once (think upgrade vs fresh) done on php 5.3 and than switch to 7 (maybe correct new issues iff happens) one is good to go from there up to php 8 etc.. (each php version in 7 has some quircks itself) as base is set ..
@jimako @tgtje

I am in no hurry; I am pretty sure it's been at least a decade since we last had an upgrade. I figure we'll need to update php; ewe're currently running on 5.2.17. Calendar has been very sparsely used, so I am not worried so much about it. Forum is the biggest thing I need to keep intact, as it houses our character sheets, discussions, so on. There's also the XP system, which runs off one of the databases. I know I am in a bit over my head and not at all too proud to ask for help; I do tend to try to do things myself if it's something I can learn, but I know this is a bit beyond my skill level. I don't mind tinkering with graphics and such either if need be; I don't know how much leeway I get with that with themes. That's all stuff that was set up before I came in. Near as I can tell, that'd be around 2005 or 2006.


If you've the time and inclination to help, I know I and my players would be most grateful. Fortunately, our chat system runs seperately (something I am also looking to update but haven't found one to our liking yet), so at least I don't have to worry about it in doing this.
@Windthin I think I can make some time this weekend. I'd need to see the files and database to understand the complexity of your website but seeing that the forum is the crucial thing I think it shouldn't give too much issues. My concern is outdated themes or plugins. Anyway, please find me on Gitter: http://gitter.im/Moc to have a chat. You can also reach my by email on moc [at] e107.org
If you've the time, the offer is appreciated and I will contact you there. There's no rush, we've been running this way a while. I expect I will want to do backups right before anything is done. I admit I am worried about over-writing vital info more than anything else or breaking the site in a way I can't fix it.
Welcome to e107 Q&A, where you can ask questions and receive answers from other members of the e107 community.
988 questions
1,384 answers
2,511 users