# Saltx
Using Saltstack with Bitwarden/Vaultwarden credential management - locally or via salt-ssh.
---
## Features
- Assistant for initial set-up of Git and Salt on the system
- Download the Bitwarden CLI tool for local use
- Data storage in encrypted folder based on EncFS
- Sync of local credential storage with a Bitwarden/Vaultwarden organization containing Salt States/Pillars
- Management of a local clone of a Git repository with Salt States/Pillars
- Wrapper for simplifying the use of salt-call locally
- Simplifying the use of salt-ssh for managing hosts with Salt via ssh
- Configurable via config files on three layers (system-global, vault, user)
- Support of multiple instances of local repositories and credential stores
- Simple installation
---
## Installation
Install as root user using PyPi:
```shell
pip3 install saltx
```
Note that this no longer works in more recent environments as `pip3` should no longer install in the system environment. You may do
```shell
pip3 install saltx --break-system-packages
```
to override. Alternatively use `pipx` (install via `apt install pipx` on Debian) like this:
```shell
PIPX_HOME=/opt/pipx PIPX_BIN_DIR=/usr/bin pipx install saltx
```
You may use another directory than `/opt/pipx` but it must be accessible for the user that will run `saltx` later (i.e. don't use the default directory located within the root home directory if you also want to run as non-root user). `PIPX_BIN_DIR` needs to be in the system search path (`systemd-path search-binaries-default` on Debian).
---
## License
[![License](http://img.shields.io/:license-agpl3-blue.svg?style=flat-square)](https://opensource.org/licenses/AGPL-3.0)
- **[AGPL3 license](https://opensource.org/licenses/AGPL-3.0)**
- Copyright 2024 © <a href="https://www.towalink.net" target="_blank">Dirk Henrici</a>.
Raw data
{
"_id": null,
"home_page": "https://www.github.com/towalink/saltx",
"name": "saltx",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "Saltstack Bitwarden Vaultwarden automation",
"author": "Dirk Henrici",
"author_email": "towalink.saltx@henrici.name",
"download_url": "https://files.pythonhosted.org/packages/f9/18/39a0af16cff3ffaa4474b9742a926eee05bcef0b11df7cecd6ecba8904a8/saltx-0.1.0.tar.gz",
"platform": null,
"description": "# Saltx\n\nUsing Saltstack with Bitwarden/Vaultwarden credential management - locally or via salt-ssh.\n\n---\n\n## Features\n\n- Assistant for initial set-up of Git and Salt on the system\n- Download the Bitwarden CLI tool for local use\n- Data storage in encrypted folder based on EncFS\n- Sync of local credential storage with a Bitwarden/Vaultwarden organization containing Salt States/Pillars\n- Management of a local clone of a Git repository with Salt States/Pillars\n- Wrapper for simplifying the use of salt-call locally\n- Simplifying the use of salt-ssh for managing hosts with Salt via ssh\n- Configurable via config files on three layers (system-global, vault, user)\n- Support of multiple instances of local repositories and credential stores\n- Simple installation\n\n---\n\n## Installation\n\nInstall as root user using PyPi:\n\n```shell\npip3 install saltx\n```\n\nNote that this no longer works in more recent environments as `pip3` should no longer install in the system environment. You may do\n\n```shell\npip3 install saltx --break-system-packages\n```\n\nto override. Alternatively use `pipx` (install via `apt install pipx` on Debian) like this:\n\n```shell\nPIPX_HOME=/opt/pipx PIPX_BIN_DIR=/usr/bin pipx install saltx\n```\n\nYou may use another directory than `/opt/pipx` but it must be accessible for the user that will run `saltx` later (i.e. don't use the default directory located within the root home directory if you also want to run as non-root user). `PIPX_BIN_DIR` needs to be in the system search path (`systemd-path search-binaries-default` on Debian).\n\n---\n\n## License\n\n[![License](http://img.shields.io/:license-agpl3-blue.svg?style=flat-square)](https://opensource.org/licenses/AGPL-3.0)\n\n- **[AGPL3 license](https://opensource.org/licenses/AGPL-3.0)**\n- Copyright 2024 \u00a9 <a href=\"https://www.towalink.net\" target=\"_blank\">Dirk Henrici</a>.\n",
"bugtrack_url": null,
"license": null,
"summary": "using Saltstack with Bitwarden/Vaultwarden credential management - locally or via salt-ssh",
"version": "0.1.0",
"project_urls": {
"Documentation": "https://www.github.com/towalink/saltx",
"Homepage": "https://www.github.com/towalink/saltx",
"Project homepage": "https://www.github.com/towalink/saltx",
"Repository": "https://www.github.com/towalink/saltx"
},
"split_keywords": [
"saltstack",
"bitwarden",
"vaultwarden",
"automation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e422b88588e190ec88b1d1549b60b14ca92666026afaf285fb0b187104601a02",
"md5": "1cb87f570192c8210fa5f9466b741633",
"sha256": "991f67c691014fdb090afc8e86e2be18b91acc0519313f9957fab85bbdcfcbab"
},
"downloads": -1,
"filename": "saltx-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1cb87f570192c8210fa5f9466b741633",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 40846,
"upload_time": "2024-11-24T12:20:36",
"upload_time_iso_8601": "2024-11-24T12:20:36.844320Z",
"url": "https://files.pythonhosted.org/packages/e4/22/b88588e190ec88b1d1549b60b14ca92666026afaf285fb0b187104601a02/saltx-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f91839a0af16cff3ffaa4474b9742a926eee05bcef0b11df7cecd6ecba8904a8",
"md5": "a1d3e1cab5e9c56241d4c145ddce97aa",
"sha256": "d491ab8ce47abeb1496dd2f285a55f143058f5cfd52f1e62a1b054f013ab0353"
},
"downloads": -1,
"filename": "saltx-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "a1d3e1cab5e9c56241d4c145ddce97aa",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 36115,
"upload_time": "2024-11-24T12:20:38",
"upload_time_iso_8601": "2024-11-24T12:20:38.903657Z",
"url": "https://files.pythonhosted.org/packages/f9/18/39a0af16cff3ffaa4474b9742a926eee05bcef0b11df7cecd6ecba8904a8/saltx-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-24 12:20:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "towalink",
"github_project": "saltx",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "saltx"
}