Connect

After you have logged in to the host, you can connect to the Workspace.

Connect Command

Use connect after host login completes.

throughwalls connect  --ip <host-ip>  --workspace-password <workspace-password>

The host needs time to boot and finish system setup. If you try to connect immediately after installation, the CLI may wait until setup is complete.

Credentials

When you run throughwalls connect, you connect to the Workspace. On a fresh installation, the Workspace has two users: root and username. After you run throughwalls connect, you will be asked to choose one of them. At first, both users use the same password as the host. You can pass the Workspace user's password with --workspace-password, with the THROUGHWALLS_WORKSPACE_PASSWORD environment variable, or through the config file. After connecting, you can manage users and passwords the same way you would on a regular Linux system.

If you prefer, you can connect to the Workspace through SSH. To do that, move your public key into the Workspace and pass the path to the private key with --workspace-ssh-key, with the THROUGHWALLS_WORKSPACE_SSH_KEY environment variable, or through the config file. If the private key is protected by a passphrase, you can also pass it with --workspace-ssh-passphrase, with the THROUGHWALLS_WORKSPACE_SSH_PASSPHRASE environment variable, or through the config file.

When the same parameter is provided in multiple places, Throughwalls uses this priority: flag -> environment variable -> config file. For example, if you set the Workspace username with an environment variable and then pass it again with --workspace-username, the username from the flag is used. If you set SSH login data in the config file and then pass a password with --workspace-password, password authentication is used instead.

Seamlessness

throughwalls connect is designed to stay attached to the Workspace. When you switch to another snapshot, the terminal where you ran throughwalls connect automatically shows a loading state. After the switch finishes, you are placed directly into the new Workspace with the data from the selected snapshot.