First, make sure your server meets the requirements. They're few but essential.
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 the latest version from here
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:
|Database Hostname||The address of your database server. In the vast majority of cases this will be
|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
|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.|
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.
You must have those folders writable
When you complete the install, Microweber will create a file at
In this file you will see an option
'installed' => true,if you wish to make new install, you must set this option to
Your Microweber application uses the Laravel config class in order to load the system variables, such as database credentials and internal settings.
If you get some errors and would like to debug them, you can enable the debug output from the file
You must set
'debug' => true on this line
Database configuration file
The database credentials are located in
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
Note: Please do not use www. in the folder name.
After that when you visit second-domain.com, you will see the install screen.
You can also do the install from command line with
php artisan microweber:install firstname.lastname@example.org admin password storage/database1.sqlite microweber microweber nopass sqlite -p site_ -t dream -d 1 -c 1 --env=second-domain.com