210 lines
11 KiB
Markdown
210 lines
11 KiB
Markdown
# XPipe Vault (Keep this repository private!)
|
|
|
|
This repository contains all connection information that is designated to be shared.
|
|
|
|
You can sync with this repository in all XPipe application instances the same way, every change you make in one instance will be reflected in the repository.
|
|
|
|
## Category list
|
|
|
|
- **Connections**
|
|
- [**Proxmox Kladow**](categories/d50cc68a-3f92-42e8-b595-adfef1189d0b)
|
|
- [**VM**](categories/d0b3e32d-0e90-4484-a0ef-6af941a6dda7)
|
|
- [**Hosts**](categories/548c3618-9d59-4626-bc01-c24c3981a5a3)
|
|
- [**Container**](categories/2ebe169e-536e-4fd2-8e78-724996990fcc)
|
|
- [**Proxmox Hetzner**](categories/93b3c4d3-0549-45a4-a257-01c50efdcd0a)
|
|
- [**VM**](categories/fa303626-ee14-4bc2-b054-fb63b6bb1149)
|
|
- [**Hosts**](categories/62e4a26d-ad45-4a8f-a8b4-e63866fd2546)
|
|
- [**Container**](categories/0b2c0094-af5e-4002-8ab5-c4accf4f110e)
|
|
- [**local**](categories/86013773-4fa9-4b5e-96ad-4ac3dc8e8412)
|
|
- [**Default**](categories/97458c07-75c0-4f9d-a06e-92d8cdf67c40)
|
|
- [**Boot**](categories/a2617d04-fd39-4a6b-9e53-c9abfa46ab0d)
|
|
- **Scripts**
|
|
- [**Custom**](categories/d3496db5-b709-41f9-abc0-ee0a660fbab9)
|
|
- **Identities**
|
|
- [**Synced**](categories/69aa5040-28dc-451e-b4ff-1192ce5e1e3c)
|
|
- **Macros**
|
|
|
|
## Connection list
|
|
|
|
**All connections / Proxmox Kladow**
|
|
|
|
empty
|
|
|
|
**All connections / Proxmox Kladow / VM**
|
|
|
|
- [**Univention fileserver archiv**](stores/6c706dfa-a3af-4a39-8d46-76c2e81e0c2c)
|
|
- [**Univention fileserver laufend**](stores/3965987a-d040-4067-a424-96fef0acd4f6)
|
|
- [**Univention PDC02**](stores/f4456d84-018b-44c7-a8ac-a9b7d1a3a960)
|
|
|
|
**All connections / Proxmox Kladow / Hosts**
|
|
|
|
- [**Proxmox Kladow Backup**](stores/8bcb2816-4273-4b84-a9aa-9788a412c633)
|
|
- [**Proxmox Kladow main**](stores/42090d28-ac8f-47f4-83b5-deb9f24cb8df)
|
|
- [**Proxmox Kladow PBS02**](stores/b316ff0d-248d-4386-abad-9a2a9ec226cb)
|
|
|
|
**All connections / Proxmox Kladow / Container**
|
|
|
|
- [**pihole**](stores/543fd734-85a0-45f3-b9a5-f47c775ea94b)
|
|
- [**wireguard**](stores/765f9104-a04c-424a-99e7-4e585b4334d7)
|
|
|
|
**All connections / Proxmox Hetzner**
|
|
|
|
empty
|
|
|
|
**All connections / Proxmox Hetzner / VM**
|
|
|
|
- [**Terminalserver 174**](stores/205bef19-12ff-47ce-9870-0ccf4dfde314)
|
|
- [**Unvention fileserver Archiv**](stores/ae859d7c-ce1e-4cfb-993a-aac2bfc5a54f)
|
|
- [**Unvention fileserver ausgelagert**](stores/7bf51d12-fcc5-4f63-a7d3-6af982d13b40)
|
|
- [**Unvention fileserver laufend**](stores/66b22e93-fb7e-49e5-b6ed-0ab4166ed0a4)
|
|
- [**Docker containers**](stores/54171b8d-3555-4307-ba5e-20ac0ac4a4ea)
|
|
- [**Unvention Mail**](stores/82a3fd3e-082b-455c-bf1f-097850228b0d)
|
|
- [**Docker containers**](stores/92d7ceec-ae9a-4eff-9f32-e62095440fe0)
|
|
- [**default**](stores/39db0736-05b3-4c1a-b802-d53e574724d1)
|
|
- [**Shell environments**](stores/112e16ca-c827-4f6a-bf19-174e63eca6ac)
|
|
- [**sudo**](stores/e9d3fa04-054a-4742-a97a-d1ad7072ea53)
|
|
- [**Unvention nextcloud Guacamole**](stores/4a9d10dc-ea72-4ec6-9fa8-09350a1dcdac)
|
|
- [**Docker containers**](stores/89664f36-8d8f-4f5c-b321-ffd557dd5b27)
|
|
- [**default**](stores/d624b927-48e4-4925-8107-341f3fc9b93d)
|
|
- [**Shell environments**](stores/a5d08507-15d2-493c-bbf6-06b542eb5db2)
|
|
- [**sudo**](stores/3fb03602-c5fc-4f44-86dd-eee32cc9b41c)
|
|
- [**Unvention PDC**](stores/0228b4d3-e1e7-4c0e-a3c6-f84a6fb15b10)
|
|
- [**Docker containers**](stores/1adb4861-2b66-4252-ab45-d95901fcf7a2)
|
|
- [**default**](stores/b942c26b-a545-41d8-9881-b688f80df367)
|
|
- [**Shell environments**](stores/e7f36e76-d15a-44e5-af8d-92dbd28d6ccf)
|
|
- [**bash**](stores/eb554591-a61d-413c-a843-51a2cbcc0b7f)
|
|
- [**dash**](stores/4f67e721-de09-4cd8-8c4e-261357e757a2)
|
|
- [**sudo**](stores/1c3c02b0-be9c-41d7-bcbe-060c5fc7e09b)
|
|
|
|
**All connections / Proxmox Hetzner / Hosts**
|
|
|
|
- [**Proxmox Hetzner**](stores/ad0a88c2-b577-490e-8d5b-693e9a0da790)
|
|
- [**Proxmox Hetzner PBS**](stores/488ac586-e7d0-4606-99b3-71893e996449)
|
|
|
|
**All connections / Proxmox Hetzner / Container**
|
|
|
|
- [**docker immich**](stores/7513fedc-580f-4723-a3e8-4015848a1c73)
|
|
- [**Docker containers**](stores/fbe1b1dd-3ab6-4911-a11c-ba30bb4ce858)
|
|
- [**default**](stores/32316c50-0e0a-4c6b-8979-1165ba916189)
|
|
- [**docker rustdesk**](stores/4e8464f3-195c-4d41-8157-2f614538c61a)
|
|
- [**Docker containers**](stores/86dbc262-b56c-41c9-b822-e00cd86b441d)
|
|
- [**default**](stores/a96f492d-6c2a-43eb-98bc-a4957fc8300a)
|
|
- [**docker-baikal**](stores/1eec68c5-8b44-4dc1-9538-be321f0e5d1a)
|
|
- [**Docker containers**](stores/39ae0714-8d26-4392-bacc-a27172f46980)
|
|
- [**default**](stores/5689dfdd-5eb0-4638-a989-f39ccf807aca)
|
|
- [**Shell environments**](stores/83649c48-0a9f-3ed6-99dd-264cae2123f5)
|
|
- [**bash**](stores/c0832cb6-3b64-44da-b936-e0b09e9b4f46)
|
|
- [**dash**](stores/69f3d33e-e3cc-4d6e-9333-3d89575e3e1e)
|
|
- [**docker-ip-symcon**](stores/ae1c8599-5bc0-48b9-9b1e-9b3ac55bd7c1)
|
|
- [**Docker containers**](stores/b9884f44-b46f-4c5e-9eab-3204d710b949)
|
|
- [**default**](stores/f7bb26c4-a0e1-4e8d-86d8-bc385240962c)
|
|
- [**Shell environments**](stores/0cbaaa7d-ceaf-3ac5-8ea5-18b792a988ce)
|
|
- [**ash**](stores/561d3927-b089-496f-a206-a379fdbbb748)
|
|
- [**docker-vaultwarden**](stores/16d6783c-bcce-4cc7-963a-110e385c3ecf)
|
|
- [**Docker containers**](stores/393ef643-16da-4778-8ec6-690ab17878b9)
|
|
- [**default**](stores/d782c9ff-6377-4a5e-a735-782ac66a3cd5)
|
|
- [**Shell environments**](stores/78edb935-52e1-33d6-92b1-fa8033474ccf)
|
|
- [**bash**](stores/014509f6-64ec-4511-b703-a758c80d3a63)
|
|
- [**dash**](stores/7bd3a25b-beef-401f-b103-8ff3db1714bd)
|
|
- [**dolibarr**](stores/435e8beb-3eee-42b3-b0dc-730bd3ffdc90)
|
|
- [**Shell environments**](stores/e815a621-42ef-38b7-a3f8-aae28a1b278f)
|
|
- [**bash**](stores/e1334962-7b25-4e62-b961-2c8826dbdbea)
|
|
- [**dash**](stores/fb9d6781-92c3-45a9-aaca-6b3210320b2f)
|
|
- [**ecomailz**](stores/a6f96658-d009-475c-8b34-1739887b147a)
|
|
- [**Shell environments**](stores/65353629-b850-3e01-8632-1ee81be3cc83)
|
|
- [**bash**](stores/52203dda-11b7-4c0b-8d19-20fd4c93a24f)
|
|
- [**dash**](stores/5a252c89-a1ff-4c89-83ac-d1a12fa962fd)
|
|
- [**gitea**](stores/a28016a2-bedd-4317-9577-c3b13459a841)
|
|
- [**Shell environments**](stores/5abe7816-b2f6-3023-bb73-d5d0e5e9bc72)
|
|
- [**bash**](stores/341ccf7f-08c2-47b8-9e8e-2f5f47ce4295)
|
|
- [**dash**](stores/30da6137-4a13-4289-86b8-8b2e6d9514f4)
|
|
- [**Influxdb**](stores/e3b9d53e-3b70-4dd2-81d5-b8be0499e10b)
|
|
- [**Shell environments**](stores/10b9fbae-fd5d-368a-bda2-041359b593f5)
|
|
- [**bash**](stores/5b0a56c7-2212-4d87-bd05-f9d1d26262b4)
|
|
- [**dash**](stores/f32b6d78-22d7-485c-833e-e69b65cd72d6)
|
|
- [**Lizenzserver**](stores/82e0a0e7-a122-414a-a349-91cd722f13d8)
|
|
- [**mysql**](stores/f6acf7ad-f263-4634-b299-6576e5997399)
|
|
- [**pihole**](stores/0be798c5-c9c0-4615-b5c3-ec66bf6804a5)
|
|
- [**proxmox mailgateway**](stores/b9b6b5e4-8b5f-494c-b162-4c797cd242f1)
|
|
- [**Shell environments**](stores/0963775f-5ff5-369b-ae2b-78c09288ed3e)
|
|
- [**bash**](stores/af768250-419e-4089-8f8c-9418f56f7459)
|
|
- [**dash**](stores/f7dac094-3cda-4134-b99d-5f49163ccda6)
|
|
- [**vdirsyncer**](stores/c9a48cf4-2aea-484f-94b5-7efd8e98ab3b)
|
|
- [**wireguard**](stores/251e8de5-c6fe-4a43-81a8-c0e2d155f7a8)
|
|
|
|
**All connections / local**
|
|
|
|
empty
|
|
|
|
**All connections / Default**
|
|
|
|
- [**nextcloud guacamole**](stores/7dbd901b-ebb6-46cf-9402-1338c8849b15)
|
|
- [**Docker containers**](stores/d3d7bb1c-22c5-4fa0-9a13-d9cd6ac9c5d0)
|
|
- [**default**](stores/75eec5ad-ed9b-46e0-ae21-b49c16e98fa0)
|
|
- [**Shell environments**](stores/b698d08b-32af-44c4-aa97-eaa743585e39)
|
|
- [**bash**](stores/18dbba09-fe94-4cac-bdd1-e275347212c8)
|
|
- [**dash**](stores/eeac52fb-d562-46b4-b85e-c79183d3dc88)
|
|
- [**sudo**](stores/12950ac8-39a2-4836-ba4b-e04690ec969b)
|
|
|
|
**All connections / Boot**
|
|
|
|
empty
|
|
|
|
**All scripts / Custom**
|
|
|
|
- [**My scripts**](stores/a9945ad2-db61-4304-97d7-5dc4330691a7)
|
|
|
|
**All identities / Synced**
|
|
|
|
- [**Administrator AD**](stores/fcc5ba61-cd97-4272-95a3-f18247418326)
|
|
|
|
|
|
## Secret encryption
|
|
|
|
You have the option to fetch any sensitive information like passwords from outside sources like password managers or enter them at connection time through a prompt window. In that case, XPipe doesn't have to store any secrets itself.
|
|
|
|
In case you choose to store passwords and other secrets within XPipe, all sensitive information is encrypted when it is saved using AES with either:
|
|
|
|
- A dynamically generated key file `vaultkey` (The data can then only be decrypted with that file present)
|
|
- A custom passphrase that can be set for your user in the vault settings menu (This option can only as secure as the password you choose)
|
|
|
|
By default, general connection data is not encrypted, only secrets are.
|
|
So things like hostnames and usernames are stored without encryption, which is in line with many other tools.
|
|
There is an available setting in the vault settings menu to encrypt all connection data if you want to do that.
|
|
|
|
## Cloning the repository on other systems
|
|
|
|
Nowadays, most providers require a personal access token (PAT) to authenticate from the command-line instead of traditional passwords.
|
|
You can find common (PAT) pages here:
|
|
- **GitHub**: [Personal access tokens (classic)](https://github.com/settings/tokens)
|
|
- **GitLab**: [Personal access token](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)
|
|
- **BitBucket**: [Personal access token](https://support.atlassian.com/bitbucket-cloud/docs/access-tokens/)
|
|
- **Gitea**: `Settings -> Applications -> Manage Access Tokens section`
|
|
Set the token permission for repository to Read and Write. The rest of the token permissions can be set as Read.
|
|
|
|
Even if your git client prompts you for a password, you should enter your token unless your provider still uses passwords.
|
|
|
|
If you don't want to enter your credentials every time, you can use any git credentials manager for that.
|
|
For more information, see for example:
|
|
- https://git-scm.com/doc/credential-helpers
|
|
- https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git
|
|
|
|
Some modern git clients also take care of storing credentials automatically.
|
|
|
|
## Troubleshooting
|
|
|
|
### Adding connections to the repository
|
|
|
|
By default, no connection categories are set to sync so that you have explicit control on what connections to commit.
|
|
|
|
To have your connections of a category put inside your git repository, you first need to change its sync configuration.
|
|
In your `Connections` tab under the category overview on the left side, you can open the category configuration menu either by right-clicking the category or click on the `⚙️` icon when hovering over the category, and then clicking on the `🔧` configure button.
|
|
|
|
Then, set the `Sync with git repository` value to `Yes` to sync the category and connections to your git repository.
|
|
This will add all syncable connections in that category to the git repository.
|
|
The sync settings for a category are inherited by default from its parent if not explicitly set.
|
|
|
|
### Local connections are not synced
|
|
|
|
Any connection located under the local machine can not be shared as it refers to connections and data that are only available on the local system.
|