xpipe-mirror/README.md

176 lines
9.7 KiB
Markdown
Raw Normal View History

2023-06-23 19:52:51 +00:00
<img src="https://github.com/xpipe-io/xpipe/assets/72509152/88d750f3-8469-4c51-bb64-5b264b0e9d47" alt="drawing" width="250"/>
2022-08-13 07:29:26 +00:00
2023-11-04 05:36:47 +00:00
XPipe is a new type of shell connection hub and remote file manager that allows you to access your entire server infrastructure from your local machine. It works on top of your installed command-line programs and does not require any setup on your remote systems.
2023-06-03 23:17:27 +00:00
2023-06-08 18:34:37 +00:00
XPipe fully integrates with your tools such as your favourite text/code editors, terminals, shells, command-line tools and more. The platform is designed to be extensible, allowing anyone to add easily support for more tools or to implement custom functionality through a modular extension system.
2023-06-03 23:17:27 +00:00
2023-08-10 16:40:48 +00:00
It currently supports:
2023-09-27 00:47:51 +00:00
- [SSH](https://www.ssh.com/academy/ssh/protocol) connections, config files, and tunnels
2024-03-07 23:16:37 +00:00
- [Docker](https://www.docker.com/), [Podman](https://podman.io/), and [LXD](https://linuxcontainers.org/lxd/introduction/) container instances located on any host
2023-08-10 16:40:48 +00:00
- [Windows Subsystem for Linux](https://ubuntu.com/wsl), [Cygwin](https://www.cygwin.com/), and [MSYS2](https://www.msys2.org/) instances
2024-03-07 23:16:37 +00:00
- [Proxmox PVE](https://www.proxmox.com/en/proxmox-virtual-environment/overview) virtual machines and containers
- [Kubernetes](https://kubernetes.io/) clusters, pods, and containers
2023-04-16 23:06:59 +00:00
- [Powershell Remote Sessions](https://learn.microsoft.com/en-us/powershell/scripting/learn/remoting/running-remote-commands?view=powershell-7.3)
2023-06-23 19:47:09 +00:00
- Any other custom remote connection methods that work through the command-line
2023-06-08 18:34:37 +00:00
2023-06-23 19:47:09 +00:00
## Connection Hub
2023-06-02 16:44:41 +00:00
2023-07-08 02:48:23 +00:00
- Easily connect to and access all kinds of remote connections in one place
2023-09-29 06:35:55 +00:00
- Allows you to create specific login environments on any system to instantly jump into a properly set up environment for every use case
2023-06-23 19:47:09 +00:00
- Can create desktop shortcuts that automatically open remote connections in your terminal
2023-12-12 16:59:05 +00:00
- Organize all your connections into hierarchical categories to keep a good overview
2023-06-02 16:44:41 +00:00
2023-12-11 16:13:25 +00:00
![connections](https://github.com/xpipe-io/xpipe/assets/72509152/5df3169a-4150-4478-a3de-ae1f9748c3c8)
2023-03-28 11:43:55 +00:00
2023-06-23 19:47:09 +00:00
## Remote File Manager
2023-01-27 02:34:46 +00:00
2023-06-02 08:42:34 +00:00
- Interact with the file system of any remote system using a workflow optimized for professionals
2023-11-04 05:36:47 +00:00
- Quickly open a terminal session into any directory in your favourite terminal emulator
2023-03-28 11:56:11 +00:00
- Utilize your favourite local programs to open and edit remote files
2023-11-04 05:36:47 +00:00
- Dynamically elevate sessions with sudo when required without having to restart the session
- Integrates with your local desktop environment for a seamless transfer of local files
2023-06-08 00:00:52 +00:00
2023-12-11 16:13:25 +00:00
![browser](https://github.com/xpipe-io/xpipe/assets/72509152/4d4e4e54-17c1-4ebe-acf8-f615cfce8b3f)
2023-04-10 15:47:17 +00:00
2023-06-08 00:00:52 +00:00
## Terminal Launcher
2023-03-28 11:56:11 +00:00
- Automatically login into a shell in your favourite terminal with one click (no need to fill password prompts, etc.)
2023-06-02 17:44:55 +00:00
- Works for all kinds of shells and connections, locally and remote.
- Supports command shells (e.g. bash, PowerShell, cmd, etc.) and some database shells (e.g. PostgreSQL Shell)
2023-06-08 00:00:52 +00:00
- Comes with support for all commonly used terminal emulators across all operating systems
- Supports launches from the GUI or directly from the command-line
- Solves all encoding issues on Windows systems as all Windows shells are launched in UTF8 mode by default
2023-02-27 05:38:36 +00:00
2023-06-08 18:34:37 +00:00
<br>
2023-06-08 15:31:54 +00:00
<p align="center">
2023-11-04 05:36:47 +00:00
<img src="https://github.com/xpipe-io/xpipe/assets/72509152/02351317-f25d-4af3-8116-bc3b4fb92312" alt="Terminal launcher"/>
2023-06-08 15:31:54 +00:00
</p>
2023-06-08 18:34:37 +00:00
<br>
2023-06-08 15:08:15 +00:00
2023-11-04 05:36:47 +00:00
## Versatile scripting system
- Create reusable simple shell scripts, templates, and groups to run on connected remote systems
- Automatically make your scripts available in the PATH on any remote system without any setup
- Setup shell init environments for connections to fully customize your work environment for every purpose
- Open custom shells and custom remote connections by providing your own commands
2023-12-11 16:13:25 +00:00
![scripts](https://github.com/xpipe-io/xpipe/assets/72509152/56533f22-b689-4201-b58a-eebe0a6d517a)
2023-06-23 19:47:09 +00:00
2023-12-12 16:59:05 +00:00
## Secure Vault
- Securely stores all information exclusively on your system,
optionally with a custom master passphrase to further encrypt secrets
- Supports syncing your vault data via your own remote git repository
- Can integrate with your password manager to fetch secrets and not store them itself
2023-11-04 05:36:47 +00:00
# Downloads
Note that this is a desktop application that should be run on your local desktop workstation, not on any server or containers. It will be able to connect to your server infrastructure from there.
2023-08-26 03:13:08 +00:00
2024-01-18 22:12:37 +00:00
## Windows
2023-06-23 19:47:09 +00:00
2024-01-18 22:12:37 +00:00
Installers are the easiest way to get started and come with an optional automatic update functionality:
2023-06-23 19:47:09 +00:00
- [Windows .msi Installer (x86-64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-installer-windows-x86_64.msi)
2024-01-18 22:12:37 +00:00
You can also install XPipe by pasting the installation command into your terminal. This will perform the setup automatically:
2023-06-23 19:47:09 +00:00
2024-01-18 22:12:37 +00:00
```
powershell -ExecutionPolicy Bypass -Command iwr "https://raw.githubusercontent.com/xpipe-io/xpipe/master/get-xpipe.ps1" -OutFile "$env:TEMP\get-xpipe.ps1" ";" "&" "$env:TEMP\get-xpipe.ps1"
```
2023-06-23 19:47:09 +00:00
2024-01-18 22:12:37 +00:00
If you don't like installers, you can also use a portable version that is packaged as an archive:
2023-06-23 19:47:09 +00:00
2024-01-18 22:12:37 +00:00
- [Windows .zip Portable (x86-64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-portable-windows-x86_64.zip)
2023-06-23 19:47:09 +00:00
2024-01-18 22:12:37 +00:00
Alternatively, you can also use [choco](https://community.chocolatey.org/packages/xpipe) to install it with `choco install xpipe`.
2023-06-23 19:47:09 +00:00
2024-01-18 22:12:37 +00:00
## Linux
2023-06-24 08:46:08 +00:00
2024-01-18 22:12:37 +00:00
You can install XPipe by pasting the installation command into your terminal. This will perform the setup automatically.
The script supports installation via `apt`, `dnf`, `yum`, `zypper`, `rpm`, and `pacman` on Linux:
2023-08-10 16:40:48 +00:00
2023-06-23 19:47:09 +00:00
```
2024-01-18 22:12:37 +00:00
bash <(curl -sL https://raw.githubusercontent.com/xpipe-io/xpipe/master/get-xpipe.sh)
2023-06-23 19:47:09 +00:00
```
2024-01-18 22:12:37 +00:00
### Debian-based distros
2023-09-30 07:04:09 +00:00
2024-01-18 22:12:37 +00:00
The following debian installers are available:
2023-09-28 06:30:53 +00:00
2024-01-18 22:12:37 +00:00
- [Linux .deb Installer (x86-64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-installer-linux-x86_64.deb)
- [Linux .deb Installer (ARM 64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-installer-linux-arm64.deb)
2023-09-28 06:30:53 +00:00
2024-01-18 22:12:37 +00:00
Note that you should use apt to install the package with `sudo apt install <file>` as other package managers, for example dpkg,
are not able to resolve and install any dependency packages.
2024-01-11 19:51:17 +00:00
2024-01-18 22:12:37 +00:00
### RHEL-based distros
The following rpm installers are available:
- [Linux .rpm Installer (x86-64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-installer-linux-x86_64.rpm)
- [Linux .rpm Installer (ARM 64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-installer-linux-arm64.rpm)
The same applies here, you should use a package manager that supports resolving and installing required dependencies if needed.
### Arch
There is an official [AUR package](https://aur.archlinux.org/packages/xpipe) available that you can either install manually or via an AUR helper such as with `yay -S xpipe`.
### NixOS
There's an official [xpipe nixpkg](https://search.nixos.org/packages?channel=unstable&show=xpipe&from=0&size=50&sort=relevance&type=packages&query=xpipe) available that you can install with `nix-env -iA nixos.xpipe`. This one is however not always up to date.
2024-01-11 19:51:17 +00:00
2024-01-11 19:54:09 +00:00
There is also a custom repository that contains the latest up-to-date releases: https://github.com/xpipe-io/nixpkg.
2024-01-11 19:51:17 +00:00
You can install XPipe by following the instructions in the linked repository.
2024-01-18 22:12:37 +00:00
### Portable
In case you prefer to use an archive version that you can extract anywhere, you can use these:
- [Linux .tar.gz Portable (x86-64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-portable-linux-x86_64.tar.gz)
- [Linux .tar.gz Portable (ARM 64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-portable-linux-arm64.tar.gz)
Note that this assumes that you have some basic packages for graphical systems already installed
as it is not a perfect standalone version. It should however run on most systems.
## macOS
2023-10-05 11:53:52 +00:00
2024-01-18 22:12:37 +00:00
Installers are the easiest way to get started and come with an optional automatic update functionality:
- [MacOS .pkg Installer (x86-64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-installer-macos-x86_64.pkg)
- [MacOS .pkg Installer (ARM 64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-installer-macos-arm64.pkg)
You also can install XPipe by pasting the installation command into your terminal. This will perform the `.pkg` install automatically:
```
bash <(curl -sL https://raw.githubusercontent.com/xpipe-io/xpipe/master/get-xpipe.sh)
```
If you don't like installers, you can also use a portable version that is packaged as an archive:
- [MacOS .dmg Portable (x86-64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-portable-macos-x86_64.dmg)
- [MacOS .dmg Portable (ARM 64)](https://github.com/xpipe-io/xpipe/releases/latest/download/xpipe-portable-macos-arm64.dmg)
2023-10-05 11:53:52 +00:00
2024-01-18 22:12:37 +00:00
Alternatively, you can also use [Homebrew](https://github.com/xpipe-io/homebrew-tap) to install XPipe with `brew install --cask xpipe-io/tap/xpipe`.
2023-09-30 07:04:09 +00:00
2024-01-11 19:54:09 +00:00
# Further information
2023-08-23 09:05:12 +00:00
## Open source model
2023-08-23 09:04:32 +00:00
2023-09-27 00:47:51 +00:00
XPipe utilizes an open core model, which essentially means that the main application is open source while certain other components are not. Select parts are not open source yet, but may be added to this repository in the future.
This mainly concerns the features only available in the professional tier and the shell handling library implementation. Furthermore, some CI pipelines and tests that run on private servers are also not included in this repository.
2023-08-23 09:04:32 +00:00
2024-01-11 19:54:09 +00:00
## More links
2023-02-08 21:34:19 +00:00
2023-10-14 16:13:04 +00:00
You have more questions? Then check out the [FAQ](https://xpipe.io/faq).
2023-09-27 00:47:51 +00:00
2023-11-15 03:25:18 +00:00
For information about the security model of XPipe, see the [security page](https://docs.xpipe.io/security).
2022-06-17 22:29:41 +00:00
2023-11-15 03:25:18 +00:00
For information about the privacy policy of XPipe, see the [privacy page](https://docs.xpipe.io/privacy-policy).
2023-04-21 13:04:19 +00:00
2023-10-05 11:53:52 +00:00
In case you're interested in development, check out the [contributing page](/CONTRIBUTING.md).
2023-06-02 08:42:34 +00:00
2023-12-11 16:18:53 +00:00
[![Discord](https://discordapp.com/api/guilds/979695018782646285/widget.png?style=banner2)](https://discord.gg/8y89vS8cRb)