SampleDB
SampleDB is a web-based sample and measurement metadata database.
Documentation
You can find the documentation for the current release at https://scientific-it-systems.iffgit.fz-juelich.de/SampleDB/.
Getting Started
We recommend using our pre-built Docker images for setting up SampleDB. You will need two containers, one for a PostgreSQL database and another for SampleDB itself, and a directory to store all files in. If you would like to set up a development version of SampleDB instead, please see the contribution guide.
First, start your database container:
docker run \
-d \
-e POSTGRES_PASSWORD= \
-e PGDATA=/var/lib/postgresql/data/pgdata \
-v `pwd`/pgdata:/var/lib/postgresql/data/pgdata:rw \
--restart=always \
--name sampledb-postgres \
postgres:12
Next, start the SampleDB container:
docker run \
-d \
--link sampledb-postgres \
-e SAMPLEDB_MAIL_SERVER=mail.example.com \
-e SAMPLEDB_MAIL_SENDER=sampledb@example.com \
-e SAMPLEDB_CONTACT_EMAIL=sampledb@example.com \
-e SAMPLEDB_SQLALCHEMY_DATABASE_URI=postgresql+psycopg2://postgres:@sampledb-postgres:5432/postgres \
-e SAMPLEDB_FILE_STORAGE_PATH=/home/sampledb/files/ \
-v `pwd`/files:/home/sampledb/files:rw \
--restart=always \
--name sampledb \
-p 8000:8000 \
docker.pkg.github.com/sciapp/sampledb/sampledb:0.8.1
This will start a basic SampleDB instance at http://localhost:8000.
To use the administration scripts, run:
docker exec sampledb env/bin/python -m sampledb help
and replace help with the script you want to run.
Next steps:
-
You can set additional configuration environment variables to customize or enable some features, including LDAP authentication and JupyterHub integration. You should at least configure a valid mail server, sender and contact email.
-
You can use the administration scripts to create instruments, actions and bot users for use with the WebAPI.
-
If you wish to run SampleDB in production, please ensure that you make backups of your database and the file directory, and ensure that your server stays secure. We strongly recommend placing SampleDB behind an nginx reverse proxy for TLS termination.
-
To update an existing SampleDB instance, please create a full backup and then start the SampleDB container using the new image.
Contributing
If you want to improve SampleDB, please read the contribution guide for a few notes on how to report issues or submit changes.
1 maintainer
Metadata
1 maintainer
Release files for sampledb 0.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sampledb-0.8.1.tar.gz | 1.5 MB | Details |
Release files / sampledb-0.8.1.tar.gz
| Download URL | sampledb-0.8.1.tar.gz |
|---|---|
| Size | 1.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
959b233d7d2aca1fcbadd694e787598d668bb53ef4f9f9faca2351dd682fb6a6
|
|
BLAKE2b-256 checksum How to use checksums |
c3d3ba4fbe1e93c5973353b06ea95a683e0fb95c7bf660c322c9d5c4818f1b82
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.40.2 CPython/3.8.0
|
