Installation

First, make sure your server meets the requirements. They're few but essential.

If you're not into reading check out this installation guide video

Note: After install Microweber will create or modify an .htaccess file in its base folder. It will also create several such files for each script directory denying access to the code.

Download via Composer

composer create-project microweber/microweber my_site dev-master 

Download manually

Download the latest version from here

https://microweber.com/download.php

Install process

Open your website in a browser (i.e. http://example.com/). You should see the following screen that allows you to initially setup your Microweber installation.

Microweber needs a database to store the content of your website. You must have at least one of the following database engines MySQL, Sqlite or Pgsql

During installation you have to configure the database connection and create an admin account. This will be the only way to manage your website. The fields you will need to fill are:

Field Description
Database Hostname The address of your database server. In the vast majority of cases this will be localhost or 127.0.0.1, but if your hosting provider gave you a different address you must specify it.
Database Username The username provided by your hosting company for database connection. Some hosting providers allow you to create your own. We don't recommend using the root user in production websites.
Database Password The database user password
Database Name The name of your database. It has to already exist on the server or the specified database user has to have privileges to create one.
Table Prefix In case the database provided is not exclusively dedicated to one Microweber installation you should set a prefix to distinguish your website's data from other data.
Admin Username Your username of choice for managing your website. We recommend you use your real name or something harder to guess than the default "admin".
Admin E-mail Please use a valid e-mail. You may need it for password recovery or website notifications.
Admin Password Please set a password as long and hard to guess as you can come up with. Also make it easy to remember.

Click the Install button and give it about a minute to set up your website. Once the installation's completed the page will offer you to view your newly created website or go straight to the admin panel.

Alternative installation methods

There is alternative installation method that can be used for automated installs.

Install Microweber via command line

Writable folders

You must have those folders writable

  • config
  • storage
  • userfiles

After install

When you complete the install, Microweber will create a file at config/microweber.php

In this file you will see an option 'installed' => true,if you wish to make new install, you must set this option to false

Configuration

Your Microweber application uses the Laravel config class in order to load the system variables, such as database credentials and internal settings.

Enable debugging

If you get some errors and would like to debug them, you can enable the debug output from the file config/app.php

You must set 'debug' => true on this line

Database configuration file

The database credentials are located in config/database.php

The sample database config file can be viewed here: https://github.com/microweber/microweber/blob/master/config/database.php

Multi site setup

You can use a single Microweber instance to manage multiple domains with separate installs.

In order to have a second site on the same installation you need to set your DNS A record(s) to point to the same IP as your primary Microweber installation.

To make an install, just create a folder in "config", e.g. "config/second-domain.com", and then make an empty file at config/second-domain.com/microweber.php

Note: Please do not use www. in the folder name.

After that when you visit second-domain.com, you will see the install screen.

The documentation is under development. Help us by editing this page.