XBackBone/docs/installation.md
Sergio Brighenti 5babd409db Readme updated
2020-04-02 18:54:11 +02:00

2.3 KiB

layout title nav_order
default Installation 2

Installation

Prerequisites

XBackBone require PHP >= 7.1, 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.
  • (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' => 'storage',
	],
	'db' => [
		'connection' => 'sqlite', // current support for sqlite and mysql
		'dsn' => 'resources/database/xbackbone.db',
		'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 }