Setting up the Site
Let us create a new site and call it
Note: Before you create any new site, you need to activate the Barracuda file format on your MariaDB installation.
Copy the following default ERPNext database settings into your
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
default-character-set = utf8mb4
You can then install a new site, by the command
bench new-site library.
This will create a new database and site folder and install
frappe (which is also an application!) in the new site. The
frappe application has two built-in modules Core and Website. The Core module contains the basic models for the application. Frappe is a batteries included framework and comes with a lot of built-in models. These models are called DocTypes. More on that later.
$ bench new-site library
MySQL root password:
Updating frappe : [========================================]
Updating country info : [========================================]
Set Administrator password:
Re-enter Administrator password:
*** Scheduler is disabled ***
A new folder called
library will be created in the
sites folder. Here is the standard folder structure for a site.
│ └── backups
│ └── files
public/files is where user uploaded files are stored.
private/backups is where backups are dumped
site_config.json is where site level configurations are maintained.
In case you have multiple sites on your bench, you can map these sites to your localhost by adding your site name to the
/etc/hosts file in the following manner:
# Host Database
# localhost is used to configure the loopback interface
# when the system is booting. Do not change this entry.
127.0.0.1 localhost library
On saving this file, your site can be accessed by mentioning it's URL in your browser.
Now let us install our app
library_management in our site
- Install library_management in library with:
bench --site [site_name] install-app [app_name]
$ bench --site library install-app library_management