(instances-access-files)= # How to access files in an instance You can manage files inside an instance using the LXD client without needing to access the instance through the network. Files can be individually edited or deleted, pushed from or pulled to the local machine. Alternatively, you can mount the instance's file system onto the local machine. For containers, these file operations always work and are handled directly by LXD. For virtual machines, the `lxd-agent` process must be running inside of the virtual machine for them to work. ## Edit instance files To edit an instance file from your local machine, enter the following command: lxc file edit / For example, to edit the `/etc/hosts` file in the instance, enter the following command: lxc file edit my-container/etc/hosts ```{note} The file must already exist on the instance. You cannot use the `edit` command to create a file on the instance. ``` ## Delete files from the instance To delete a file from your instance, enter the following command: lxc file delete / ## Pull files from the instance to the local machine To pull a file from your instance to your local machine, enter the following command: lxc file pull / For example, to pull the `/etc/hosts` file to the current directory, enter the following command: lxc file pull my-instance/etc/hosts . Instead of pulling the instance file into a file on the local system, you can also pull it to stdout and pipe it to stdin of another command. This can be useful, for example, to check a log file: lxc file pull my-instance/var/log/syslog - | less To pull a directory with all contents, enter the following command: lxc file pull -r / ## Push files from the local machine to the instance To push a file from your local machine to your instance, enter the following command: lxc file push / You can specify the file permissions by adding the `--gid`, `--uid`, and `--mode` flags. To push a directory with all contents, enter the following command: lxc file push -r / ## Mount a file system from the instance You can mount an instance file system into a local path on your client. To do so, make sure that you have `sshfs` installed. Then run the following command (note that if you're using the snap, the command requires root permissions): lxc file mount / You can then access the files from your local machine. ### Set up an SSH SFTP listener Alternatively, you can set up an SSH SFTP listener. This method allows you to connect with any SFTP client and with a dedicated user name. Also, if you're using the snap, it does not require root permission. To do so, first set up the listener by entering the following command: lxc file mount [--listen
:] For example, to set up the listener on a random port on the local machine (for example, `127.0.0.1:45467`): lxc file mount my-instance If you want to access your instance files from outside your local network, you can pass a specific address and port: lxc file mount my-instance --listen 192.0.2.50:2222 ```{caution} Be careful when doing this, because it exposes your instance remotely. ``` To set up the listener on a specific address and a random port: lxc file mount my-instance --listen 192.0.2.50:0 The command prints out the assigned port and a user name and password for the connection. ```{tip} You can specify a user name by passing the `--auth-user` flag. ``` Use this information to access the file system. For example, if you want to use `sshfs` to connect, enter the following command: sshfs @
: -p For example: sshfs xFn8ai8c@127.0.0.1:/home my-instance-files -p 35147 You can then access the file system of your instance at the specified location on the local machine.