| Name | cista JSON |
| Version |
1.1.1
JSON |
| download |
| home_page | None |
| Summary | Dropbox-like file server with modern web interface |
| upload_time | 2025-08-17 16:33:27 |
| maintainer | Vasanko |
| docs_url | None |
| author | Vasanko |
| requires_python | >=3.11 |
| license | None |
| keywords |
dropbox
file-server
storage
web-interface
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Cista Web Storage
<img src="https://git.zi.fi/Vasanko/cista-storage/raw/branch/main/docs/cista.webp" align=left width=250>
Cista takes its name from the ancient *cistae*, metal containers used by Greeks and Egyptians to safeguard valuable items. This modern application provides a browser interface for secure and accessible file storage, echoing the trust and reliability of its historical namesake.
This is a cutting-edge **file and document server** designed for speed, efficiency, and unparalleled ease of use. Experience **lightning-fast browsing**, thanks to the file list maintained directly in your browser and updated from server filesystem events, coupled with our highly optimized code. Fully **keyboard-navigable** and with a responsive layout, Cista flawlessly adapts to your devices, providing a seamless experience wherever you are. Our powerful **instant search** means you're always just a few keystrokes away from finding exactly what you need. Press **1/2/3** to switch ordering, navigate with all four arrow keys (+Shift to select). Or click your way around on **breadcrumbs that remember where you were**.
**Built-in document and media previews** let you quickly view files without downloading them. Cista shows PDF and other documents, video and image thumbnails, with **HDR10 support** video previews and image formats, including HEIC and AVIF. It also has a player for music and video files.
The Cista project started as an inevitable remake of [Droppy](https://github.com/droppyjs/droppy) which we used and loved despite its numerous bugs. Cista Storage stands out in handling even the most exotic filenames, ensuring a smooth experience where others falter.
All of this is wrapped in an intuitive interface with automatic light and dark themes, making Cista Storage the ideal choice for anyone seeking a reliable, versatile, and quick file storage solution. Quickly setup your own Cista where your files are just a click away, safe, and always accessible.
Experience Cista by visiting [Cista Demo](https://drop.zi.fi) for a test run and perhaps upload something...
## Getting Started
### Running the Server
We recommend using [UV](https://docs.astral.sh/uv/getting-started/installation/) to directly run Cista:
Create an account: (otherwise the server is public for all)
```fish
uvx cista --user yourname --privileged
```
Serve your files at http://localhost:8000:
```fish
uvx cista -l :8000 /path/to/files
```
Alternatively, you can install with `pip` or `uv pip`. This enables using the `cista` command directly without `uvx` or `uv run`.
```fish
pip install cista --break-system-packages
```
The server remembers its settings in the config folder (default `~/.local/share/cista/`), including the listen port and directory, for future runs without arguments.
### Internet Access
Most admins find the [Caddy](https://caddyserver.com/) web server convenient for its auto TLS certificates and all. A proxy also allows running multiple web services or Cista instances on the same IP address but different (sub)domains.
`/etc/caddy/Caddyfile`:
```Caddyfile
cista.example.com {
reverse_proxy :8000
}
```
Nxing or other proxy may be similarly used, or alternatively you can place cert and key in cista config dir and run `cista -l cista.example.com`
## System Deployment
This setup allows easy addition of storages, each with its own domain, configuration, and files.
Assuming a restricted user account `storage` for serving files and that UV is installed system-wide or on this account. Only UV is required: this does not use git or bun/npm.
Create `/etc/systemd/system/cista@.service`:
```ini
[Unit]
Description=Cista storage %i
[Service]
User=storage
ExecStart=uvx cista -c /srv/cista/%i -l /srv/cista/%i/socket /media/storage/%i
Restart=always
[Install]
WantedBy=multi-user.target
```
This setup supports multiple storages, each under `/media/storage/<domain>` for files and `/srv/cista/<domain>/` for configuration. UNIX sockets are used instead of numeric ports for convenience.
```fish
systemctl daemon-reload
systemctl enable --now cista@foo.example.com
systemctl enable --now cista@bar.example.com
```
Public exposure is easiest using the Caddy web server.
`/etc/caddy/Caddyfile`:
```Caddyfile
foo.example.com, bar.example.com {
reverse_proxy unix//srv/cista/{host}/socket
}
```
## Development setup
For rapid development, we use the Vite development server for the Vue frontend, while running the backend on port 8000 that Vite proxies backend requests to. Each server live reloads whenever its code or configuration are modified.
Make sure you have git, uv and bun (or npm) installed.
Backend (Python) – setup and run:
```fish
git clone https://git.zi.fi/Vasanko/cista-storage.git
cd cista-storage
uv sync --dev
uv run cista --dev -l :8000 /path/to/files
```
Frontend (Vue/Vite) – run the dev server in another terminal:
```fish
cd frontend
bun install
bun run dev
```
Building the package for release (frontend + Python wheel/sdist):
```fish
uv build
```
Vue is used to build files in `cista/wwwroot`, included prebuilt in the Python package. `uv build` runs the project build hooks to bundle the frontend and produce a NodeJS-independent Python package.
Raw data
{
"_id": null,
"home_page": null,
"name": "cista",
"maintainer": "Vasanko",
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "dropbox, file-server, storage, web-interface",
"author": "Vasanko",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/ad/3c/79850d45c669ff583d5c68122597602b3753ba3ce54fdd264f302a529b22/cista-1.1.1.tar.gz",
"platform": null,
"description": "# Cista Web Storage\n\n<img src=\"https://git.zi.fi/Vasanko/cista-storage/raw/branch/main/docs/cista.webp\" align=left width=250>\n\nCista takes its name from the ancient *cistae*, metal containers used by Greeks and Egyptians to safeguard valuable items. This modern application provides a browser interface for secure and accessible file storage, echoing the trust and reliability of its historical namesake.\n\nThis is a cutting-edge **file and document server** designed for speed, efficiency, and unparalleled ease of use. Experience **lightning-fast browsing**, thanks to the file list maintained directly in your browser and updated from server filesystem events, coupled with our highly optimized code. Fully **keyboard-navigable** and with a responsive layout, Cista flawlessly adapts to your devices, providing a seamless experience wherever you are. Our powerful **instant search** means you're always just a few keystrokes away from finding exactly what you need. Press **1/2/3** to switch ordering, navigate with all four arrow keys (+Shift to select). Or click your way around on **breadcrumbs that remember where you were**.\n\n**Built-in document and media previews** let you quickly view files without downloading them. Cista shows PDF and other documents, video and image thumbnails, with **HDR10 support** video previews and image formats, including HEIC and AVIF. It also has a player for music and video files.\n\nThe Cista project started as an inevitable remake of [Droppy](https://github.com/droppyjs/droppy) which we used and loved despite its numerous bugs. Cista Storage stands out in handling even the most exotic filenames, ensuring a smooth experience where others falter.\n\nAll of this is wrapped in an intuitive interface with automatic light and dark themes, making Cista Storage the ideal choice for anyone seeking a reliable, versatile, and quick file storage solution. Quickly setup your own Cista where your files are just a click away, safe, and always accessible.\n\nExperience Cista by visiting [Cista Demo](https://drop.zi.fi) for a test run and perhaps upload something...\n\n\n## Getting Started\n### Running the Server\n\nWe recommend using [UV](https://docs.astral.sh/uv/getting-started/installation/) to directly run Cista:\n\nCreate an account: (otherwise the server is public for all)\n```fish\nuvx cista --user yourname --privileged\n```\n\nServe your files at http://localhost:8000:\n```fish\nuvx cista -l :8000 /path/to/files\n```\n\nAlternatively, you can install with `pip` or `uv pip`. This enables using the `cista` command directly without `uvx` or `uv run`.\n\n```fish\npip install cista --break-system-packages\n```\n\nThe server remembers its settings in the config folder (default `~/.local/share/cista/`), including the listen port and directory, for future runs without arguments.\n\n### Internet Access\n\nMost admins find the [Caddy](https://caddyserver.com/) web server convenient for its auto TLS certificates and all. A proxy also allows running multiple web services or Cista instances on the same IP address but different (sub)domains.\n\n`/etc/caddy/Caddyfile`:\n\n```Caddyfile\ncista.example.com {\n reverse_proxy :8000\n}\n```\n\nNxing or other proxy may be similarly used, or alternatively you can place cert and key in cista config dir and run `cista -l cista.example.com`\n\n## System Deployment\n\nThis setup allows easy addition of storages, each with its own domain, configuration, and files.\n\nAssuming a restricted user account `storage` for serving files and that UV is installed system-wide or on this account. Only UV is required: this does not use git or bun/npm.\n\nCreate `/etc/systemd/system/cista@.service`:\n\n```ini\n[Unit]\nDescription=Cista storage %i\n\n[Service]\nUser=storage\nExecStart=uvx cista -c /srv/cista/%i -l /srv/cista/%i/socket /media/storage/%i\nRestart=always\n\n[Install]\nWantedBy=multi-user.target\n```\n\nThis setup supports multiple storages, each under `/media/storage/<domain>` for files and `/srv/cista/<domain>/` for configuration. UNIX sockets are used instead of numeric ports for convenience.\n\n```fish\nsystemctl daemon-reload\nsystemctl enable --now cista@foo.example.com\nsystemctl enable --now cista@bar.example.com\n```\n\nPublic exposure is easiest using the Caddy web server.\n\n`/etc/caddy/Caddyfile`:\n\n```Caddyfile\nfoo.example.com, bar.example.com {\n reverse_proxy unix//srv/cista/{host}/socket\n}\n```\n\n## Development setup\n\nFor rapid development, we use the Vite development server for the Vue frontend, while running the backend on port 8000 that Vite proxies backend requests to. Each server live reloads whenever its code or configuration are modified.\n\nMake sure you have git, uv and bun (or npm) installed.\n\nBackend (Python) \u2013 setup and run:\n\n```fish\ngit clone https://git.zi.fi/Vasanko/cista-storage.git\ncd cista-storage\nuv sync --dev\nuv run cista --dev -l :8000 /path/to/files\n```\n\nFrontend (Vue/Vite) \u2013 run the dev server in another terminal:\n\n```fish\ncd frontend\nbun install\nbun run dev\n```\n\nBuilding the package for release (frontend + Python wheel/sdist):\n\n```fish\nuv build\n```\n\nVue is used to build files in `cista/wwwroot`, included prebuilt in the Python package. `uv build` runs the project build hooks to bundle the frontend and produce a NodeJS-independent Python package.\n",
"bugtrack_url": null,
"license": null,
"summary": "Dropbox-like file server with modern web interface",
"version": "1.1.1",
"project_urls": {
"Homepage": "https://git.zi.fi/Vasanko/cista-storage"
},
"split_keywords": [
"dropbox",
" file-server",
" storage",
" web-interface"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "d80d2b5c9a2088152e757982b86952c829a49698920c5acce31d4af46dfa14e8",
"md5": "cec8bb11728573045a71a70661c2802b",
"sha256": "13da17048f1044cc2758db6ebe5f27bb2d493292798667658d8308ef206ca27f"
},
"downloads": -1,
"filename": "cista-1.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cec8bb11728573045a71a70661c2802b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 143085,
"upload_time": "2025-08-17T16:33:26",
"upload_time_iso_8601": "2025-08-17T16:33:26.156937Z",
"url": "https://files.pythonhosted.org/packages/d8/0d/2b5c9a2088152e757982b86952c829a49698920c5acce31d4af46dfa14e8/cista-1.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "ad3c79850d45c669ff583d5c68122597602b3753ba3ce54fdd264f302a529b22",
"md5": "86badca7c47724667054fef46e8513bc",
"sha256": "3c5ba1a0963d69dc5ae088d4a377d534b2c4d147659cf6b54526b33708394760"
},
"downloads": -1,
"filename": "cista-1.1.1.tar.gz",
"has_sig": false,
"md5_digest": "86badca7c47724667054fef46e8513bc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 116756,
"upload_time": "2025-08-17T16:33:27",
"upload_time_iso_8601": "2025-08-17T16:33:27.600818Z",
"url": "https://files.pythonhosted.org/packages/ad/3c/79850d45c669ff583d5c68122597602b3753ba3ce54fdd264f302a529b22/cista-1.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-17 16:33:27",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "cista"
}
