xPipe/README.md

268 lines
15 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 systems**](stores/649a8346-e8fa-441e-af2d-9b145378b95c)
- [**3CX-SBC**](stores/95f58141-ffca-49e1-867a-5d2d8569c38e)
- [**docker-main**](stores/2c77b976-a5b6-4b23-a5fc-ad67f1aaf599)
- [**Ecockpit**](stores/e07606c5-ee29-48d0-86df-6f2978d45e43)
- [**fileserver-archiv**](stores/25b05cd3-cace-438a-914b-39a09e558c25)
- [**fileserver-laufend**](stores/df612640-0579-4fa6-8f18-fd7ec3312a88)
- [**PDC02**](stores/56e91bbc-d28f-4dcc-99aa-92d6cca2b446)
- [**pihole**](stores/967be629-a586-4bfe-9879-4f6145974085)
- [**Services**](stores/6ddf27d1-9c95-4734-9b8a-18ffcff95d60)
- [**PVE dashboard**](stores/987d3319-cb21-4ab3-b9c3-0a2fcfa1f30f)
- [**wireguard**](stores/c8404255-df21-406d-adbb-d1587cbb3796)
- [**workstationneuerMaster**](stores/81785ea3-bc8e-4ea8-9f76-06da907f0704)
- [**XP**](stores/4ec4ab94-965f-4bb6-b187-7129d130747d)
- [**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**
- [**Arista firewall**](stores/1c871ff7-634c-44cb-9287-d695fee6fe90)
- [**Shell environments**](stores/79d339e5-dc1f-48b1-bc0f-de733d68e449)
- [**bash**](stores/79e40968-2dfb-4a71-b30d-ca5a5e708edf)
- [**Unvention fileserver Archiv**](stores/ae859d7c-ce1e-4cfb-993a-aac2bfc5a54f)
- [**Docker containers**](stores/49e5e68e-0929-4489-a1c3-d08fdc97b26f)
- [**default**](stores/2a3dab66-603c-4261-9aaf-a80e8cd10943)
- [**Shell environments**](stores/b6b10dc8-2fa9-4d34-aa5b-076d169c0c3e)
- [**sudo**](stores/5c7f2853-8846-4551-8dbd-5560fce92896)
- [**Unvention fileserver ausgelagert**](stores/7bf51d12-fcc5-4f63-a7d3-6af982d13b40)
- [**Docker containers**](stores/73378192-5908-4756-9266-206cfba5840c)
- [**default**](stores/5ee4dfdc-9cb4-4c9c-a49d-17cc65e0281f)
- [**Shell environments**](stores/934aecff-e12a-446f-9776-ce069fdafe1b)
- [**sudo**](stores/70c3dc6a-953a-4cad-a09e-8c1cbc85d7a8)
- [**Unvention fileserver laufend**](stores/66b22e93-fb7e-49e5-b6ed-0ab4166ed0a4)
- [**Docker containers**](stores/54171b8d-3555-4307-ba5e-20ac0ac4a4ea)
- [**default**](stores/cafeeca5-cd08-46f4-accd-dbfd723f5878)
- [**Shell environments**](stores/770c3a0b-a4b0-4ad6-9075-7515f21006b1)
- [**sudo**](stores/2793fb4c-18bc-471d-9c02-19fbbd120073)
- [**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 systems**](stores/621ab147-f05c-4361-a6e4-52393dfa56d6)
- [**CT127**](stores/00548d43-26bb-4a3b-a43f-126ad83c732a)
- [**DMS01**](stores/8a0e377a-c3d4-4acc-afaa-007f8a8e8a2a)
- [**docker-baikal**](stores/156c2535-5190-4600-a7f2-a690080d4a93)
- [**docker-immich**](stores/1c5b3ea8-2ef6-486a-a20d-9d1f18ec67bb)
- [**docker-ipsymcon**](stores/f76484bd-9e32-4eb7-a5dc-25156bf31161)
- [**docker-rustdesk**](stores/20117001-36ab-4ffe-b496-6c35aa781e3a)
- [**docker-vaultwarden**](stores/9737d380-e588-4ed1-9cc1-8c0680463619)
- [**dolibarr**](stores/52f2395d-5fc8-40e4-9456-5d15f2008d13)
- [**ecomailz**](stores/5031474f-2fb7-4a7f-8226-c1d57d3ac16c)
- [**fileserver-archiv**](stores/99856a36-c08f-4166-abb2-875432f3a46e)
- [**fileserver-ausgelagert**](stores/00f09752-2c95-48e0-b9a8-094d046caf2e)
- [**fileserver-laufend**](stores/00618610-10e3-4ca3-83cf-3502bed617df)
- [**FW01**](stores/b3b35b5f-270c-4258-95e6-00ab293d0ada)
- [**gitea**](stores/efb2516a-d6be-435f-8d0f-3a69e31998a0)
- [**influxdb**](stores/348d87f1-5c26-4779-8353-06e5fd72c75d)
- [**licenseserver**](stores/c1e4280b-b651-4f85-9d7c-6777a2ccae63)
- [**MAIL01**](stores/e7a90d80-a76f-46fc-9df4-5658e990d464)
- [**mySQL**](stores/3fba9bc0-f868-4b64-bcf4-767a80463a58)
- [**Nextcloud-Guacamole**](stores/bc95d345-60cb-4875-919a-70064073c80d)
- [**nginxproxymanager**](stores/5a807a65-f244-4f4d-8ff2-261154d44003)
- [**PBX01**](stores/2776c60b-08d2-4c0d-98e0-44a4abba0d29)
- [**PDC01**](stores/6cb141e8-c4e0-4033-9ee3-376d86f16daa)
- [**pihole**](stores/123201be-ae24-4158-9c7f-382053b57281)
- [**pmg01**](stores/ef86e98c-a036-4a3f-9414-8c5d3d9af187)
- [**Services**](stores/073a4bc5-5e0e-468d-bfbe-2507d5effa47)
- [**PVE dashboard**](stores/f172a93e-06b7-4f93-822b-6e0a480a5991)
- [**vdirsyncer**](stores/59cead92-e732-464b-a93b-2356847b5e68)
- [**WEB01**](stores/88fad5ad-93d2-461f-a7c7-99da7fdf9036)
- [**wireguard**](stores/639e1863-d118-4ea5-a2ac-8603a6d54766)
- [**workstation-arbeit**](stores/84987176-afae-479e-a898-cdc26a74e4a5)
- [**workstation-original**](stores/84f10e46-bc9b-4aa1-af7e-84cb56ec547c)
- [**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.