A self-hosted shelf for storing links for easy visual reference.

Bokmärken is a Swedish word, meaning Bookmarks in English.

Bokmärken was heavily inspired by Minne, a linkshelf project of socketubs.

It also includes a REST API to import/export and play with your links.

A responsive design for every device.

On a Debian or Ubuntu system, you need to install the following packages:

sudo apt-get install libxml2-dev libxslt1-dev

and create a virtualenv:

cd ~/
git clone https://github.com/pabluk/bokmarken.git
cd bokmarken
virtualenv venv
source venv/bin/activate
pip install -r requirements.txt
edit bokmarken/settings.py # Set SECRET_KEY
python manage.py syncdb --migrate --noinput
python manage.py createsuperuser --username=admin --email=admin@localhost  # enter a password for the admin user
python manage.py runserver

Open your browser at https://localhost:8000/ and sign in with your credentials.

By default links are stored in a SQLite3 database. If you want to use another database backend supported by Django, for example PostgreSQL, you need to install additional packages:

sudo apt-get install libpq-dev

on the already created and activated virtualenv:

pip install psycopg2==2.5.1

and finally, add your database settings on bokmarken/local_settings.py. See this page for more details about database settings on Django.

Want to contribute? Great! Bug reports, code and documentation patches are greatly appreciated.
Please file bugs and send pull requests using the issue tracker.

The image used by default on links without thumbnails is licensed under a Creative Commons license by gpoo.

Licensed under AGPL v3. See LICENSE for details.