Files
gotermix/README.md
T

34 lines
1.2 KiB
Markdown
Raw Normal View History

2026-05-22 19:04:00 +01:00
# Go web terminal
2026-05-22 19:08:51 +01:00
- the app runs with access as user who started it!
2026-05-22 19:04:00 +01:00
- it runs on https ( default is random ssl certifcate generated during start)
- you can turn off user account required to access it during startup
- default user account is `ivor` and pw `Silv3rSw0rd!`
2026-05-22 19:17:08 +01:00
- you can upload and download files - as long as user has to it access who has terminal session
2026-05-22 18:36:34 +01:00
2026-05-22 19:04:00 +01:00
## Usage:
2026-05-22 19:08:51 +01:00
- listen address (default "127.0.0.1:5000")
`./gotermix -addr <string>`
- disable password authentication
`./gotermix -nopw`
- set login username (next arg is password) and restart the app.
`./gotermix -setlogin <string>`
-s et a cert (validates it first, then stores paths encrypted, exits)
`./gotermix -cert /etc/ssl/my.crt -certkey /etc/ssl/my.key`
- combined cert+key PEM file (omit -certkey)
`./gotermix -cert /etc/ssl/combined.pem`
- remove stored cert, revert to self-signed
`./gotermix -certreset`
2026-05-22 19:04:00 +01:00
## Set custom encryption password for the .json file during build
`export GOTERMINAL_ENC="SoMeStRongPasSwoR2d"`
`go build -ldflags "-X main.fileEncKeyHex=${GOTERMINAL_ENC}" .`
## or one-liner:
`go build -ldflags "-X main.fileEncKeyHex=$(openssl rand -hex 32)" .`
2026-05-22 19:17:08 +01:00
![Login Page](.samples/login-page.png "Login Page")
![Terminal](.samples/terminal.png "Terminal")