django-livesettings / docs / installation.rst

Installation

Requirements

Installing Livesettings

After the dependencies have been installed, you can install the latest livesettings, using:

pip install -e hg+http://bitbucket.org/bkroeze/django-livesettings/#egg=django-livesettings

Add livesettings to your installed apps in :file:`settings.py`:

INSTALLED_APPS = (
    ...
    # Uncomment the next line to enable the admin:
    'django.contrib.admin',
    'livesettings',
    'myapp'
    ...
)

It is high recommended to configure a global cache (like MemcachedCache) for multiprocess servers! Otherwise the processes would not be notified about new values with the default LocMemCache. The default configuration is safe for a debug server (manage.py runserver).

Add it to your :file:`urls.py`:

urlpatterns = patterns('',
    ...
    # Uncomment the next line to enable the admin:
    url(r'^admin/', include(admin.site.urls)),
    url(r'^settings/', include('livesettings.urls')),
    ...
)

Execute a syncdb to create the required tables:

python manage.py syncdb
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.