summaryrefslogtreecommitdiff
path: root/docs/install-example.txt
blob: 4024f0d627a2d251e9ad44197d01830d7b07809d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
Paste Installation
++++++++++++++++++

Installation of Paste-enabled applications is consistent and reliable;
you don't have to understand what technologies those applications
used.  Paste-enabled applications are installable with `easy_install
<>`_, like::

    $ easy_install FileBrowser
    ... messages ...

Once an application is installed, you can set up an instance of that
application with ``paste deploy``::

    $ paste deploy FileBrowser location
    ... @@: make this work ;) ...

This just wrote to ``location/filebrowser.ini`` -- you can configure
the application there, with whatever specifics that application needs.
Then you can integrate it into your website and other applications,
with a file like::

    [composit:main]
    use = egg:Paste#urlmap
    /browser = config:filebrowser.ini

You can attach applications to many locations using this.  Once you've
set that file up with your local settings and preferences, you can
run::

    $ paster serve location/apps.ini --daemon

And it will be running in the background.