synocommunity/spkrepo repository overview

⁠spkrepo

Synology Package Repository

⁠Development

⁠Installation

1. Install dependencies with poetry install
2. Run the next commands in the virtual environment poetry shell
3. Create the tables with python manage.py db create
4. Populate the database with some fake packages with python manage.py db populate
5. Add an user with python manage.py user create -u Admin -e [email protected] -p adminadmin
6. Grant the created user with Administrator permissions python manage.py user add_role -u [email protected] -r admin
7. Grant the created user with Package Administrator permissions python manage.py user add_role -u [email protected] -r package_admin
8. Grant the created user with Developer permissions python manage.py user add_role -u [email protected] -r developer

To reset the environment, clean up with python manage.py clean.

⁠Run

1. Start the development server with python manage.py runserver
2. Website is available at http://localhost:5000⁠
3. Admin interface is available at http://localhost:5000/admin⁠
4. NAS interface is available at http://localhost:5000/nas⁠
5. API is available at http://localhost:5000/api⁠
6. Run the test suite with poetry run pytest -v

⁠Deployment

⁠Configuration

Create a config file ./config.py to disable debug logs, connect to a database, set a secure key and optionally set a cache:

Use LC_CTYPE=C tr -cd '[:print:]' < /dev/urandom | head -c 64 or base64 < /dev/urandom | head -c 64 to get a random string

DEBUG = False
TESTING = False
SECRET_KEY = "Please-change-me-to-some-random-string"
SQLALCHEMY_ECHO = False
SQLALCHEMY_DATABASE_URI = "postgresql://user:pass@localhost/dbname"
# https://pythonhosted.org/Flask-Caching/#configuring-flask-caching
CACHE_TYPE= "simple"
# For signing packages
GNUPG_PATH= "/usr/local/bin/gpg"

⁠Docker

Example usage:

docker run -it --rm --name spkrepo -v $(pwd)/data:/data -v $(pwd)/docker-config.py:/usr/src/app/spkrepo/config.py -p 8000:8000 synocommunity/spkrepo

⁠Serve app via a WSGI server⁠.

Example:

pip install gunicorn
SPKREPO_CONFIG="$PWD/config.py" gunicorn -w 4 'wsgi:app'