Skip to content
master
Go to file
Code
This branch is 61 commits ahead, 420 commits behind bartTC:master.

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
bin
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.rst

xelpaste

xelpaste is a Django based pastebin, based on the dpaste project. It's intended to run separately but it is also possible to be installed into an existing Django project like a regular app.

You can find a live example on http://xelpaste.org/.

Installation

You may install this software from your distribution packages, or through pip:

$ pip install xelpaste

Once installed, you must configure it. The minimal set of settings is the [db] section of the /etc/xelpaste/config.ini file (see below for details).

Once this is configured, you must prepare the database:

$ xelpastectl migrate

This will create the database; the last step is to point your WSGI server to xelpaste.wsgi.

Configuration

Xelpaste will read all configuration files matching /etc/xelpaste/*.ini. Those are ini-style files, defining the following parameters:

Application ([app])

General behavior of the application.

Options:

mode
str, the application mode. Use dev for local development and prod otherwise.
debug
bool, whether to enable debug. Valid values: on, off
secret_key
str, REQUIRED in prod mode. A secret key for Django security hooks

Site ([site])

Hosting and URLs.

Options:

name
str, the name of your site (xelpaste, mypaster, ...).
base_url
str, where your site is hosted. A trailing slash is required.
assets_url
str, the URL where assets (CSS, JS, ...) are served. May be a relative URL.
admin_mail
str, the email where the admin should be notified.
allowed_hosts
str list, comma-separated list of valid Host: HTTP headers. See Django docs for details.

Database ([db])

Required; these define where snippets will be stored. Valid options are:

engine
str, the engine to choose. Must be one of sqlite, mysql, postgresql; default is sqlite.
name
str, the name of the database, or its path for sqlite. Defaults to /var/lib/xelpaste/db.sqlite.
host
str, the host of the database server.
port
int, the port of the database server.
user
str, the login to use to connect to the database server.
password
str, the password for the database

Examples:

; A Postgresql configuration; uses default psql port.
[db]
engine = postgresql
name = xelpaste
host = psql42.local
; A sample sqlite configuration.
[db]
engine = sqlite
name = /data/replicated/xelpaste/db.sqlite

Snippets ([snippets])

Options for snippets behavior.

slug_length
int, the length of the snippet tags.
max_content
size, the maximum size of code snippets. Valid values include 10kB, 2MB, ...
max_file
size, the maximum size for uploads Valid values include 10kB, 2MB, ...

Uploads ([uploads])

Options related to private file uploads.

dir

path, storage folder for uploads. Must be writable by the WSGI process.

Example: /var/www/xelpaste/uploads

serve

str, the file serving mode. xelpaste relies on django-sendfile to enhance performance and protection.

Valid options: simple, nginx, xsendfile, mod_wsgi.

internal_url
str, the internal URL used by django-sendfile to serve the files.

About

The Django project driving xelpaste.com/org/net/fr; based on dpaste.de

Resources

License

Packages

No packages published