README
¶
knot
Knot is a powerful tool to manage Cloud Development Environment within a Nomad cluster or local environments. It provides a seamless blend of a user-friendly web interface and a command line interface. This dual approach streamlines the deployment process and simplifies access to development environments, making management an effortless endeavor and eliminating the need for each developer to manage their own configurations.
Features
- Web-Based Management Interface: Provides an easy-to-use, browser-based interface for managing environments.
- Visual Studio Code Integration: Allows access to Visual Studio Code right from your browser.
- Code Server Integration: Offers access to Code Server right from your browser.
- Terminal Access: Offers in-browser terminal access for seamless command-line operations.
- Command-Line Tools: Simplifies container access with handy command-line tools.
- User & Permission Management: Effectively manage users and their permissions.
- Groups: Control which templates are available to users.
- Environment Templates: Customizable templates for creating consistent development environments.
- Integration with Nomad: Ensures seamless integration with Nomad for efficient cluster management.
- Local Containers: Run containers on the local machine using Docker or Podman.
- Quotas: Limit by resource usage and by number of spaces per user.
- Development URL Management: Automatically generated URLs for development spaces.
- Support for VNC: Support for web based VNC servers such as KasmVNC.
- Remote Servers Maximize performance by deploying environment close to developers but manage templates and users from anywhere, no single point failure.
- Custom Roles: Create custom roles to manage permissions.
- Sharing: Spaces can be shared with other users allowing SSH and terminal access.
- Logging: Syslog compatible interface allows logging and display within a window.
- Tunneling: Securely expose development environments to the internet when required.
- Local Services Securely connect to services on your local machine from within a space.
- API: Provides an API for integration with other systems.
API Versioning
The API version is specified in the request header:
X-Knot-Api-Version: 2025-03-10
Any non-breaking changes are available in all versions of the API while breaking changes are only available in the latest version of the API.
Security
knot is designed to be used within trusted environments rather than on the open internet, that is it is expected to be run on a private network with developers connecting to the it via a VPN or similar technology.
For complex deployments over many different locations a mesh network may be appropriate.
When tunneling is enabled the tunnel port is separate from the web interface and the agent interface, it is expected that public traffic be directed to the tunnel interface only.
Time-based one-time passwords (TOTP) should be enabled if the web interface is exposed to the internet. The TOTP code works with Google Authenticator, Microsoft Authenticator, and other TOTP apps.
Documentation
Documentation and Getting Started
Icons
Icons are sourced from:
- https://heroicons.com/outline
- https://flowbite.com/icons/
- https://github.com/homarr-labs/dashboard-icons
- https://github.com/devicons/devicon
Legal
Disclaimer: All product names, trademarks, and registered trademarks are the property of their respective owners. Icons are used for identification purposes only and do not imply endorsement.
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd/scriptlingserver
Package scriptlingserver implements the plugin the scriptling CLI loads to use knot libraries and scripts.
|
Package scriptlingserver implements the plugin the scriptling CLI loads to use knot libraries and scripts. |
|
integration-tests
|
|
|
harness
Package harness boots real knot servers and spaces for black-box API integration tests.
|
Package harness boots real knot servers and spaces for black-box API integration tests. |
|
internal
|
|
|
agentapi/agentproxy
Package agentproxy provides self-contained TCP/TLS stream-to-local-port proxying.
|
Package agentproxy provides self-contained TCP/TLS stream-to-local-port proxying. |
|
agentpackages
Package agentpackages caches scriptling package zips (knot.zip, libs.zip) for the in-space agent service API.
|
Package agentpackages caches scriptling package zips (knot.zip, libs.zip) for the in-space agent service API. |
|
authratelimit
Package authratelimit implements failed-login blocking.
|
Package authratelimit implements failed-login blocking. |
|
desktop
Package desktop implements knot's desktop mode: bare `knot` runs the full server (identical to `knot server`) plus a system tray icon whose menu offers to open the web UI in the default browser and to quit.
|
Package desktop implements knot's desktop mode: bare `knot` runs the full server (identical to `knot server`) plus a system tray icon whose menu offers to open the web UI in the default browser and to quit. |
|
lmchatkit
Package lmchatkit adapts the github.com/paularlott/lmchatkit library to knot's per-user, MCP-backed chat architecture.
|
Package lmchatkit adapts the github.com/paularlott/lmchatkit library to knot's per-user, MCP-backed chat architecture. |
|
scriptling/pluginfetch
Package pluginfetch implements the knot plugin's fetcher: the source of truth for knot:// scheme sources served to the scriptling CLI.
|
Package pluginfetch implements the knot plugin's fetcher: the source of truth for knot:// scheme sources served to the scriptling CLI. |
|
specwizard
Package specwizard implements the conversion layer between knot's native template spec formats (local container YAML and Nomad HCL) and the unified representation the web wizard edits.
|
Package specwizard implements the conversion layer between knot's native template spec formats (local container YAML and Nomad HCL) and the unified representation the web wizard edits. |
|
scripts
|
|
|
genico
command
Assembles a multi-size .ico (32-bit BGRA DIB entries + zero AND masks) from input PNGs; sizes come from the PNG dimensions.
|
Assembles a multi-size .ico (32-bit BGRA DIB entries + zero AND masks) from input PNGs; sizes come from the PNG dimensions. |
|
getversion
command
|
|
|
homebrew-formula
command
|
|
|
iconlist
command
|
|
|
iconthin
command
iconthin thins the strokes of a monochrome icon without altering its geometry: it thresholds the alpha channel, erodes the resulting mask by a radius (repeated 3x3 min-filter, an approximation of a disk), then downsamples with area averaging for smooth antialiased edges.
|
iconthin thins the strokes of a monochrome icon without altering its geometry: it thresholds the alpha channel, erodes the resulting mask by a radius (repeated 3x3 min-filter, an approximation of a disk), then downsamples with area averaging for smooth antialiased edges. |