https://github.com/synocommunity/spkrepo
Synology Package Repository
https://github.com/synocommunity/spkrepo
python synology
Last synced: 12 days ago
JSON representation
Synology Package Repository
- Host: GitHub
- URL: https://github.com/synocommunity/spkrepo
- Owner: SynoCommunity
- License: mit
- Created: 2014-11-29T16:59:00.000Z (over 11 years ago)
- Default Branch: main
- Last Pushed: 2026-06-04T11:41:35.000Z (21 days ago)
- Last Synced: 2026-06-04T13:09:18.793Z (21 days ago)
- Topics: python, synology
- Language: Python
- Homepage: http://spkrepo.readthedocs.org
- Size: 1.08 MB
- Stars: 198
- Watchers: 15
- Forks: 27
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# spkrepo
Synology Package Repository
[](https://discord.gg/nnN9fgE7EF)
## Development
### Requirements
1. Install docker and docker-compose
2. Install uv
3. Install pre-commit e.g. `uv tool install pre-commit`
### Installation
1. Run postgres, e.g. using docker with `docker compose up db`
2. Install dependencies with `uv sync`
4. Create the tables with `uv run flask db upgrade`
5. Populate the database with some fake packages with `uv run flask spkrepo populate_db`
6. Add an admin account with `uv run flask spkrepo create_admin -u admin -e admin@synocommunity.com -p adminadmin`
To clean data created by fake packages, run `uv run flask spkrepo depopulate_db`
### Run
1. Start postgres with `docker compose up db`
2. Start the development server with `uv run flask run`
3. Website is available at http://localhost:5000
4. Admin interface is available at http://localhost:5000/admin
5. NAS interface is available at http://localhost:5000/nas
6. API is available at http://localhost:5000/api
7. Run the test suite with `uv run pytest -v`
### spkrepo CLI Usage
```sh
Usage: flask spkrepo [OPTIONS] COMMAND [ARGS]...
Spkrepo admin commands.
Options:
--help Show this message and exit.
Commands:
clean Clean data path.
create_admin Create a new admin user.
create_user Create a new user with an activated account.
depopulate_db Depopulate database.
populate_db Populate the database with some packages.
```
1. Add a user with `uv run flask spkrepo create_user -u admin -e admin@synocommunity.com -p adminadmin`
2. Grant the created user with Administrator permissions `uv run flask roles add admin@synocommunity.com admin`
3. Grant the created user with Package Administrator permissions `uv run flask roles add admin@synocommunity.com package_admin`
4. Grant the created user with Developer permissions `uv run flask roles add admin@synocommunity.com developer`
## Docker Compose Run
- If you also want to run the app in docker you can with `docker compose up app`
- You can run both postgres and the app with `docker compose up`
## 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
```python
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= "SimpleCache"
# For signing packages
GNUPG_PATH= "/usr/local/bin/gpg"
```
### Run Tests & Linters
```
uv run pytest -v
uvx pre-commit run --all-files
```
### Docker
Example usage:
```bash
docker run -it --rm --name spkrepo -v $(pwd)/data:/data -p 8000:8000 ghcr.io/synocommunity/spkrepo
```
Additional configuration can be mounted in the container and loaded by putting
the path into `SPKREPO_CONFIG` environment variable.
e.g.
```bash
docker run -it --rm --name spkrepo -v $(pwd)/data:/data -v $(pwd)/docker-config.py:/docker-config.py -e SPKREPO_CONFIG=/docker-config.py -p 8000:8000 ghcr.io/synocommunity/spkrepo
```
### Serve app via [a WSGI server](https://flask.palletsprojects.com/en/1.1.x/deploying/).
Example:
```bash
pip install gunicorn
SPKREPO_CONFIG="$PWD/config.py" gunicorn -w 4 'wsgi:app'
# or
SPKREPO_CONFIG="$PWD/config.py" uv run --with gunicorn gunicorn -b 0.0.0.0:8080 -w 4 wsgi:app
```
## Add migration
```bash
uv run flask db revision -m "update build path length"
```
## Test NAS API
```sh
curl "http://localhost:5000/nas?package_update_channel=beta&build=24922&language=enu&major=6µ=2&arch=x86_64&minor=2"
```