Skip to content

piger/qstode

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Nov 15, 2021
f22ec11 · Nov 15, 2021
Dec 17, 2015
Feb 9, 2019
Apr 20, 2019
Feb 4, 2019
Feb 5, 2019
Feb 7, 2019
Feb 7, 2019
Feb 9, 2019
Oct 27, 2013
Dec 10, 2013
Feb 7, 2019
Mar 30, 2014
Oct 27, 2013
Jan 21, 2014
Dec 16, 2015
Nov 15, 2021
Feb 11, 2019
Dec 16, 2015
Oct 26, 2017
Feb 7, 2019
Nov 15, 2021
Apr 19, 2019
Nov 15, 2021
Apr 19, 2019

Repository files navigation

QStode

Build Status

QStode is a web application that allows registered users to store bookmarks (like the good old del.icio.us) categorized by tags.

At the moment social functions (for example the subscription to other users bookmark feed) are missing.

Project status

THIS PROJECT IS UNMAINTAINED

QStode is mostly usable (read: it's beta) even if it still lacks some features and many things could be improved.

Things to note:

  • the search engine feature is still experimental mostly because it should really use a task queue (i.e. Celery) to handle all the write operations on the index; at the moment I'm using Whoosh AsyncWriter that relies on threads and is not suitable for high work loads.

  • a MySQL database is suggested; PostgreSQL support is experimental/incomplete.

Documentation

Documentation is available on ReadTheDocs.

Requirements

  • Python 3.x
  • a WSGI server: gunicorn, uwsgi, etc.
  • a web server with reverse proxy support

The suggested setup involves the use of a virtual environment created with virtualenv.

NOTE: You can also run QStode with the built in http server, but it's not suitable for the open internet!

Docker

A sample docker-compose.yml file is provided as a starting point to run your own instance in development mode.

To start QStode run:

docker-compose up --build

To setup the database and create the admin user, run:

docker-compose run qstode setup

To shutdown the containers run:

docker-compose down

Or run docker-compose down -v to also delete the MySQL data container.

Author(s)

QStode is written and maintained by Daniel Kertesz daniel@spatof.org.

License