File: tramp-container.el.html

Allows Tramp access to environments provided by Docker and similar programs.

## Usage

Open a file on a running Docker container:

    C-x C-f /docker:USER@CONTAINER:/path/to/file
    C-x C-f /dockercp:USER@CONTAINER:/path/to/file

or Podman:

    C-x C-f /podman:USER@CONTAINER:/path/to/file
    C-x C-f /podmancp:USER@CONTAINER:/path/to/file

Where:
    USER is the user on the container to connect as (optional).
    CONTAINER is the container to connect to.

"docker" and "podman" are inline methods, "dockercp" and "podmancp"
are out-of-band methods.

Open file in a Kubernetes container:

    C-x C-f /kubernetes:[CONTAINER.]POD[%NAMESPACE]:/path/to/file

Where:
    POD is the pod to connect to.
    CONTAINER is the container to connect to (optional).
By default, the first container in that pod will
be used.
    NAMESPACE is the namespace to be used (optional).

Open a file on an existing Toolbox container:

    C-x C-f /toolbox:CONTAINER:/path/to/file

Where:
    CONTAINER is the container to connect to (optional).

If the container is not running, it is started. If no container is specified, the default Toolbox container is used.

Open a file on an existing Distrobox container:

    C-x C-f /distrobox:CONTAINER:/path/to/file

Where:
    CONTAINER is the container to connect to.

If the container is not running, it is started.

Open a file on a running Flatpak sandbox:

    C-x C-f /flatpak:SANDBOX:/path/to/file

Where:
    SANDBOX is the running sandbox to connect to.
It could be an application ID, an instance ID, or a PID.

Open a file on a running Apptainer instance:

    C-x C-f /apptainer:INSTANCE:/path/to/file

Where:
    INSTANCE is the running instance to connect to.

Open a file on a running systemd-nspawn container:

    C-x C-f /nspawn:USER@CONTAINER:/path/to/file

Where:
    USER is the user on the container to connect as (optional)
    CONTAINER is the container to connect to

Defined variables (23)

tramp-apptainer-methodTramp method name to connect to Apptainer instances.
tramp-apptainer-programName of the Apptainer client program.
tramp-distrobox-methodTramp method name to connect to Distrobox containers.
tramp-distrobox-no-container-regexpRegexp matching missing distrobox error message.
tramp-distrobox-programName of the Distrobox client program.
tramp-docker-methodTramp method name to connect to Docker containers.
tramp-docker-programName of the Docker client program.
tramp-dockercp-methodTramp method name to connect to Docker containers.
tramp-flatpak-methodTramp method name to connect to Flatpak sandboxes.
tramp-flatpak-programName of the Flatpak client program.
tramp-kubernetes--host-name-regexpThe CONTAINER.POD%NAMESPACE syntax of kubernetes host names in Tramp.
tramp-kubernetes--name-regexpRegexp matching kubernetes names.
tramp-kubernetes-contextContext of Kubernetes.
tramp-kubernetes-methodTramp method name to connect to Kubernetes containers.
tramp-kubernetes-namespaceNamespace of Kubernetes.
tramp-kubernetes-programName of the Kubernetes client program.
tramp-nspawn-methodTramp method name to connect to systemd-nspawn containers.
tramp-nspawn-programName of the machinectl program.
tramp-podman-methodTramp method name to connect to Podman containers.
tramp-podman-programName of the Podman client program.
tramp-podmancp-methodTramp method name to connect to Podman containers.
tramp-toolbox-methodTramp method name to connect to Toolbox containers.
tramp-toolbox-programName of the Toolbox client program.

Defined functions (20)

tramp-apptainer--completion-function(METHOD)
tramp-container--completion-function(METHOD)
tramp-distrobox--completion-function(METHOD)
tramp-enable-apptainer-method()
tramp-enable-distrobox-method()
tramp-enable-flatpak-method()
tramp-enable-nspawn-method()
tramp-enable-toolbox-method()
tramp-flatpak--completion-function(METHOD)
tramp-kubernetes--completion-function(METHOD)
tramp-kubernetes--container(VEC)
tramp-kubernetes--context-namespace(VEC)
tramp-kubernetes--current-context(VEC)
tramp-kubernetes--current-context-data(VEC)
tramp-kubernetes--namespace(VEC)
tramp-kubernetes--pod(VEC)
tramp-nspawn--completion-function(METHOD)
tramp-skeleton-completion-function(METHOD &rest BODY)
tramp-skeleton-kubernetes-vector(VEC &rest BODY)
tramp-toolbox--completion-function(METHOD)

Defined faces (0)