Adding Spaces

Add new SSH connections to Kisuke with a simple configuration process. This guide covers the required information and setup steps.

Quick start

Add a new space

1. Tap the + button on the Spaces screen
2. Enter connection details
3. Enter your password
4. Tap Connect

Required fields

Field	Description	Example
Name	Display name for this space	”Development Mac”
Host	IP address or hostname	192.168.1.100
Port	SSH port (default: 22)	22
Username	Your account on the remote machine	john

Connection details

Space name

Choose a descriptive name:

• Include purpose or location
• Make it easily identifiable
• Examples: “Office Mac”, “AWS Production”, “Home Pi”

Host address

Enter the machine’s address:

Local network:

192.168.1.100
10.0.0.50
macbook.local
raspberrypi.local

Remote servers:

dev.company.com
203.0.113.45
server.example.org

Custom ports:

example.com:2222
192.168.1.100:8022

Username

Your account name on the remote machine:

• Regular user account (recommended)
• Root access (use cautiously)
• Service accounts (for automation)

Connection types

Local network connections

For devices on the same network:

1. Find device IP address
2. Ensure SSH is enabled
3. Add space with local IP
4. Connect directly

Remote connections

For internet-accessible machines:

1. Use public IP or domain
2. Ensure firewall allows SSH
3. Consider using non-standard ports
4. Enable fail2ban for security

Behind NAT/Firewall

Options for restricted networks:

• Use VPN connection first
• Configure port forwarding
• Use jump/bastion hosts
• Try Tailscale or similar

First connection

Host verification

On first connection:

1. Kisuke displays host fingerprint
2. Verify it matches your server
3. Accept to save for future connections
4. Subsequent connections verify automatically

Testing connection

After adding a space:

1. Tap to connect
2. Enter credentials if prompted
3. Terminal opens on success
4. Connection saved for quick access

After connection

Once connected to a space, you can:

• Manage projects - Organize your work folders
• Use terminal - Execute commands
• Browse files - Navigate the file system
• Edit code - Work on your files

See Managing Projects for organizing your work within spaces.

Import/Export

Importing configurations

Add multiple spaces quickly:

1. Prepare configuration file
2. Import via share sheet
3. Review imported spaces
4. Test connections

Exporting spaces

Backup your configurations:

1. Select spaces to export
2. Choose export format
3. Save or share file
4. Import on other devices

Best practices

Naming conventions

Use consistent naming:

• [Environment]-[Purpose]: “Prod-API”, “Dev-Database”
• [Location]-[Device]: “Office-Mac”, “Home-Pi”
• [Project]-[Role]: “ProjectX-Backend”, “ProjectY-Frontend”

Security considerations

• Use unique usernames per space
• Use strong, unique passwords
• Enable Face ID/Touch ID
• Regular password rotation

Next steps

• Configure authentication →
• Network setup guide →
• Managing spaces →
• Organize with projects →

Note

Kisuke validates connection details before saving. Ensure your host is reachable and SSH is enabled before adding a space.