feat(issue-11): add SSH setup script and remote access documentation #16

shoko · 2026-03-30T05:40:09+02:00

shoko commented

2026-03-30 05:40:09 +02:00

Summary

Add SSH setup capabilities for issue #11 Phase 1 completion.

Changes

sshd-setup.sh (skills/kugetsu/scripts/sshd-setup.sh)
- Automated SSH setup inside container
- Creates non-root user (configurable via argument)
- Configures sshd for key-only authentication
- Configures passwordless sudo for the user
- Enables and starts sshd via systemd
- Checks systemd prerequisite before proceeding
docs/kugetsu-setup.md
- Unified setup documentation
- Container setup (Incus, Docker)
- SSH setup (scripted + manual steps)
- Host-side port forwarding
- kugetsu installation
- Usage guide
- Remote access via SSH
SKILL.md
- Add "Remote Access via SSH (Optional)" section
- Documents sshd-setup.sh usage
- Links to full documentation

Motivation

Completes the "Headless/SSH Access" requirement for Phase 1 of issue #11.

Testing

Manual testing required:

Run sshd-setup.sh in container with systemd
Verify SSH connection from host
Verify sudo access works

Closes #11

## Summary Add SSH setup capabilities for issue #11 Phase 1 completion. ### Changes 1. **sshd-setup.sh** (`skills/kugetsu/scripts/sshd-setup.sh`) - Automated SSH setup inside container - Creates non-root user (configurable via argument) - Configures sshd for key-only authentication - Configures passwordless sudo for the user - Enables and starts sshd via systemd - Checks systemd prerequisite before proceeding 2. **docs/kugetsu-setup.md** - Unified setup documentation - Container setup (Incus, Docker) - SSH setup (scripted + manual steps) - Host-side port forwarding - kugetsu installation - Usage guide - Remote access via SSH 3. **SKILL.md** - Add "Remote Access via SSH (Optional)" section - Documents sshd-setup.sh usage - Links to full documentation ### Motivation Completes the "Headless/SSH Access" requirement for Phase 1 of issue #11. ### Testing Manual testing required: - [ ] Run sshd-setup.sh in container with systemd - [ ] Verify SSH connection from host - [ ] Verify sudo access works Closes #11

shoko added 2 commits 2026-03-30 05:40:09 +02:00

feat(issue-11): add SSH setup script and kugetsu-setup documentation 7fb9b9c581

- Add sshd-setup.sh: automated SSH setup inside container
  - Checks for systemd prerequisite
  - Creates non-root user (configurable via argument, fallback to 'kugetsu')
  - Configures sshd for key-only authentication
  - Configures passwordless sudo for the user
  - Enables and starts sshd via systemd
- Add docs/kugetsu-setup.md: unified setup documentation
  - Container setup (Incus, Docker)
  - SSH setup (automated + manual steps)
  - Host-side port forwarding (Incus, firewall)
  - kugetsu installation
  - Usage guide
  - Remote access via SSH

docs(kugetsu): add SSH remote access section to SKILL.md 31c7e254ab

- Add 'Remote Access via SSH (Optional)' section
- Documents automated sshd-setup.sh usage
- Explains what the setup does
- Shows remote usage examples
- Links to full docs/kugetsu-setup.md for host-side configuration

shoko force-pushed feat/issue-11-ssh-setup from 31c7e254ab to 1e2d88d811

2026-03-30 05:42:32 +02:00

Compare

shoko added 1 commit 2026-03-30 05:43:04 +02:00

docs: add chmod +x instruction before executing scripts 0563e7bced

Users should explicitly grant execute permission to downloaded scripts
for transparency and security best practices.

shoko referenced this pull request

2026-03-30 05:49:13 +02:00

Phase 1: Headless/SSH Access #11

shoko added 1 commit 2026-03-30 06:03:13 +02:00

docs(kugetsu-setup): simplify - remove Docker section and curl downloads 4da4d46bd1

- Remove Docker/Podman section (not tested by maintainer)
- Remove curl download instructions (assume user cloned repo)
- Add note that Incus systemd config may vary by version
- Update troubleshooting to reflect cloned repo path

shoko added 1 commit 2026-03-30 06:27:29 +02:00

feat(sshd-setup): multi-distro support and verification steps 3c92a12f28

- sshd-setup.sh: Auto-detect OS (Debian/Ubuntu/Fedora/RHEL/CentOS)
- Use appropriate package manager (apt-get vs dnf)
- Add verification steps after each major phase
- Exit with error if sshd installation fails
- Exit with error if sshd doesn't start successfully
- Add troubleshooting section in output

- kugetsu-install.sh: Add verification that kugetsu binary exists

- kugetsu-setup.md: Document multi-distro installation commands

han approved these changes 2026-03-30 07:00:25 +02:00

han left a comment

First-time contributor

lgtm

shoko referenced this pull request

2026-03-30 07:00:43 +02:00

Phase 1: Headless/SSH Access #11

shoko merged commit 3650447f9c into main

2026-03-30 07:03:32 +02:00

shoko referenced this issue from a commit

2026-03-30 07:03:33 +02:00

Merge pull request 'feat(issue-11): add SSH setup script and remote access documentation' (#16) from feat/issue-11-ssh-setup into main