app | ||
bin | ||
bootstrap | ||
logs | ||
resources | ||
src | ||
.gitignore | ||
.htaccess | ||
.travis.yml | ||
CHANGELOG.md | ||
composer.json | ||
composer.lock | ||
config.example.php | ||
Gruntfile.js | ||
index.php | ||
LICENSE | ||
package.json | ||
README.md | ||
yarn.lock |
XBackBone 📤 (https://violinist.io)
XBackBone is a simple, self-hosted, lightweight PHP backend for the instant sharing tool ShareX. It supports uploading and displaying images, GIF, video, code, formatted text, and file downloading and uploading. Also have a web UI with multi user management and past uploads history.
Features
- Supports every upload type from ShareX.
- User management, multi user features.
- Public and private uploads.
- Web UI for each user.
- Logging system.
- Auto config generator for ShareX.
How to Install
XBackBone require PHP >= 7.1
, the composer package manager, writable storage path and PDO, with installed the needed extensions (ex. php-sqlite3
for SQLite):
-
[release, stable] Download latest release from GitHub: https://github.com/SergiX44/XBackBone/releases/latest
-
Run composer from your shell:
composer install --no-dev
- Setup the config file:
cp config.example.php config.php
By default, XBackBone will use Sqlite as DB engine, and a storage
dir in the current 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 raccomanded).
return [
'base_url' => 'https://myaswesomedomain.com', // no trailing slash
'storage_dir' => 'storage',
'db' => [
'connection' => 'sqlite',
'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
- Now just login with
admin/admin
, be sure to change these credentials after your first login.
ShareX Configuration
Once you are logged in, just go in your profile settings and download the ShareX config file for your account.
Notes
If you do not use Apache, or the Apache .htaccess
is not enabled, set your web server so that the static/
folder is the only one accessible from the outside, otherwise even private uploads and logs will be accessible!
The NGINX configuration should be something like this:
# nginx configuration
location /app {
return 403;
}
location /bin {
return 403;
}
location /bootstrap {
return 403;
}
location /resources {
return 403;
}
location /storage {
return 403;
}
location /vendor {
return 403;
}
location /logs {
return 403;
}
autoindex off;
location / {
if (!-e $request_filename){
rewrite ^(.*)$ /index.php break;
}
}
Built with
- FlightPHP (http://flightphp.com/)
- Bootstrap 4 (https://getbootstrap.com/)
- Font Awesome 5 (http://fontawesome.com)
- ClipboardJS (https://clipboardjs.com/)
- HighlightJS (https://highlightjs.org/)
- JQuery (https://jquery.com/)