|
1 | 1 | # Updating
|
2 | 2 |
|
| 3 | +:::warning |
| 4 | + |
| 5 | +Flarum 2.0 is currently in beta. It is not ready for production use. Please wait for the stable release before updating your forum. |
| 6 | + |
| 7 | +::: |
| 8 | + |
3 | 9 | ## From the Admin Dashboard
|
4 | 10 |
|
5 | 11 | :::info
|
6 | 12 |
|
7 |
| -If you have the extension manager extension installed you can simply run the update from its interface and skip this page entirely. |
| 13 | +If you have the [extension manager](./extensions#extension-manager) extension installed you can simply run the update from its interface and skip the general steps. You should still read the ["Major Version Update Guide"](#major-version-update-guides) if you are updating from v1 to v2. |
8 | 14 |
|
9 | 15 | :::
|
10 | 16 |
|
11 | 17 | ---
|
12 | 18 |
|
13 | 19 | To update Flarum, you'll need to use [Composer](https://getcomposer.org). If you're not familiar with it (although you should be, because you need it to install Flarum), read [our guide](composer.md) for information on what it is and how to set it up.
|
14 | 20 |
|
15 |
| -If updating across major versions (e.g. <=0.1.0 to 1.x.x, 1.x.x to 2.x.x, ...), make sure to read the appropriate "major version update guide" before running the general upgrade steps. |
| 21 | +If updating across major versions (e.g. <=0.1.0 to 1.x.x, 1.x.x to 2.x.x, ...), make sure to read the appropriate ["Major Version Update Guide"](#major-version-update-guides) before running the general upgrade steps. |
16 | 22 |
|
17 | 23 | ## General Steps
|
18 | 24 |
|
@@ -40,11 +46,25 @@ php flarum cache:clear
|
40 | 46 |
|
41 | 47 | ### Updating from v1 (^1.0.0) to v2 (^2.0.0)
|
42 | 48 |
|
43 |
| -1. Do steps 1-5 above. |
44 |
| -2. Change the version strings of all bundled extensions (`flarum/tags`, `flarum/mentions`, `flarum/likes`, etc) in `composer.json` from `^1.0` (or `^1.8`, ...etc) to `*`. |
45 |
| -3. Change `flarum/core`'s version string in `composer.json` from `^1.0` (or `^1.8`, ...etc) to `^2.0`. |
46 |
| -4. Preferably set the `"minimum-stability": "beta",` line in your `composer.json` to `stable` unless you are still using a beta third party extension. |
47 |
| -5. Do steps 6 and 7 above. |
| 49 | +1. If you are using a MariaDB database, you should change the driver in `config.php` from `mysql` to `mariadb`: |
| 50 | + ```php |
| 51 | + <?php return array ( |
| 52 | + 'debug' => true, |
| 53 | + 'offline' => false, |
| 54 | + 'database' => |
| 55 | + array ( |
| 56 | + // remove-next-line |
| 57 | + 'driver' => 'mysql', |
| 58 | + // insert-next-line |
| 59 | + 'driver' => 'mariadb', |
| 60 | + 'host' => 'localhost', |
| 61 | + 'port' => 3306, |
| 62 | + ``` |
| 63 | +2. Do steps 1-5 above. |
| 64 | +3. Change the version strings of all bundled extensions (`flarum/tags`, `flarum/mentions`, `flarum/likes`, etc) in `composer.json` from `^1.0` (or `^1.8`, ...etc) to `*`. |
| 65 | +4. Change `flarum/core`'s version string in `composer.json` from `^1.0` (or `^1.8`, ...etc) to `^2.0`. |
| 66 | +5. Preferably set the `"minimum-stability": "beta",` line in your `composer.json` to `stable` unless you are still using a beta third party extension. |
| 67 | +6. Do steps 6 and 7 above. |
48 | 68 |
|
49 | 69 | ## Troubleshooting Issues
|
50 | 70 |
|
|
0 commit comments