Quick start guide

For using the FileBrowser, Django needs to be installed and an Admin Site has to be activated.


Install the FileBrowser:

pip install django-filebrowser

Add the filebrowser to your INSTALLED_APPS (before django.contrib.admin):


Add the FileBrowser site to your url-patterns (before any admin-urls):

from filebrowser.sites import site

urlpatterns = [
    path('admin/filebrowser/', site.urls),
    path('grappelli/', include('grappelli.urls')),
    path('admin/', admin.site.urls),

Collect the static files (please refer to the Staticfiles Documentation for more information):

python manage.py collectstatic


Check the Settings.


You need to add a folder “uploads” within site.storage.location when using the default settings.


Start the devserver and login to your admin site:

python manage.py runserver <IP-address>:8000

Goto /admin/filebrowser/browse/ and check if everything looks/works as expected. If you’re having problems, see Troubleshooting.