pkg

Documentation

Overview

AGPL v3 License Copyright (c) 2026 Project Backplane

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.

AGPL v3 License Copyright (c) 2026 Project Backplane

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.

AGPL v3 License Copyright (c) 2026 Project Backplane

Index

• Variables
• type Backplane
  • func New(opts Options) *Backplane
  • func (b *Backplane) Expose(label string, ptr interface{})
  • func (b *Backplane) Log(format string, args ...interface{})
  • func (b *Backplane) Start() (func(), error)
• type Options
  • func DefaultOptions() Options

Variables

var ReloadSignal = syscall.SIGHUP

Types

type Backplane

type Backplane struct {
	Options Options
	// contains filtered or unexported fields
}

Backplane is the main instance of the admin server

func New

func New(opts Options) *Backplane

New creates a new Backplane instance.

func (*Backplane) Expose

func (b *Backplane) Expose(label string, ptr interface{})

Expose registers an atomic variable to be editable/viewable in the admin panel. This delegates to the internal bridge.

func (*Backplane) Log

func (b *Backplane) Log(format string, args ...interface{})

Log adds a message to the internal ring buffer and external structured log.

func (*Backplane) Start

func (b *Backplane) Start() (func(), error)

Start launches the SSH server in a survivor goroutine.

type Options

type Options struct {
	// Port to listen on. Default: 2222
	Port int
	// Host to bind to. Default: "127.0.0.1" (Safety Default)
	Host string
	// Path to host key. Default: ".ssh/term_info_ed25519"
	HostKeyPath string
	// Path to authorized_keys. Default: "~/.ssh/authorized_keys"
	AuthorizedKeysPath string
	// Destination for Audit Logs. Default: os.Stdout
	AuditOutput io.Writer
	// Destination for Structured Logs (JSON). Default: os.Stderr
	LogOutput io.Writer
}

Options defines configuration for the Backplane server.

func DefaultOptions

func DefaultOptions() Options

DefaultOptions returns safe defaults.