2021-08-12 22:07:53 +02:00

2.4 KiB

Raw Blame History

layout	title	nav_order
default	Installation	2

Installation

Prerequisites

XBackBone require PHP >= 7.2, with installed the required extensions:

php-sqlite3 for SQLite.
php-mysql for MariaDB/MySQL.
php-gd image manipualtion library.
php-json json file support.
php-intl internationalization functions.
php-fileinfo file related functions.
php-zip compressed files related functions.
(optional) php-ftp to use the FTP remote storage driver.
(optional) php-ldap to use LDAP authentication.

Web installation

Download latest release from GitHub: Latest Release
Extract the release zip to your document root.
Navigate to the webspace root (ex. http://example.com/xbackbone, this should auto redirect your browser to the install page http://example.com/xbackbone/install/)
Follow the instructions.

For futher and advanced configurations, see the configuration page.

Manual installation

Download latest release from GitHub: Latest Release
Extract the release zip to your document root.
Copy and edit the config file:

cp config.example.php config.php && nano config.php

By default, XBackBone will use Sqlite3 as DB engine, and a storage dir in the main directory. You can leave these settings unchanged for a simple personal installation. You must set the base_url, or remove it for get dynamically the url from request (not recommended).

return [
	'base_url' => 'https://example.com', // no trailing slash
	'storage' => [
		'driver' => 'local',
		'path' => 'absolute/path/to/storage',
	],
	'db' => [
		'connection' => 'sqlite', // current support for sqlite and mysql
		'dsn' => 'absolute/path/to/resources/database/xbackbone.db', // if sqlite should be an absolute path
		'username' => null, // username and password not needed for sqlite
		'password' => null,
	]
];

Finally, run the migrate script to setup the database

php bin/migrate --install

Delete the /install directory.
Now just login with admin/admin, be sure to change these credentials after your first login.

For futher and advanced configurations, see the configuration page.

Docker deployment

Alternatively, a docker container is available.

Docker container{: .btn .btn-purple }

2.4 KiB Raw Blame History