Service: PicoShare - EyevinnOSC/community GitHub Wiki
PicoShare
PicoShare (serviceId mtlynch-picoshare) is a minimalist service for sharing images and other files. In Eyevinn Open Source Cloud (OSC) it is a long-running service instance with up to 10 GiB of storage per instance.
What it can do
- Upload a file by drag and drop and get a link to share with anyone who should download it.
- Protect the admin features with a passphrase that you choose.
Creating an instance
PicoShare has no dependencies on other OSC services.
- Choose a secret access key and store it with
create-service-secret(serviceIdmtlynch-picoshare), for example namemysharedsecret. See Working with Secrets. - Create the instance with
create-service-instance,serviceId: "mtlynch-picoshare":
{ "name": "guide", "SharedSecret": "{{secrets.mysharedsecret}}" }
- Wait for it to be running (
wait-for-service-readyorget-instance-status) and get the URL withdescribe-service-instance.
Options
| Option | Required | Type | Meaning |
|---|---|---|---|
| name | Yes | string | Name of the instance. Alphanumeric, at most 20 characters. |
| SharedSecret | Yes | string, sensitive | Passphrase the admin user enters to log in to PicoShare and use its admin features. Corresponds to upstream PS_SHARED_SECRET. |
Store SharedSecret as a service secret and pass it as {{secrets.NAME}} (whole field value only). Overwriting a secret does not restart a running instance.
Using the instance
Open the instance URL, click Log In and enter the access key you stored in the secret. Drag the file you want to share into the window. When the upload is completed you get a link to share with whoever should download the file.
Limitations
- Storage is limited to 10 GiB per instance.