Archived

This repository has been archived on 2026-04-03. You can view files and clone it. You cannot open issues or pull requests or push a commit.

Files

Jeffrey Smith ba4c9ca65c Feat v0.7.4 documentation + deferred surface work

Docs restructuring: category grouping (Getting Started, Platform,
Extension Development, Operations) with 14 ordered docs. Four new
guides: Permissions & Groups, Workflows, Starlark Reference, Frontend
JS Guide. Extension Guide updated with config_section docs.

Content refresh across 10 existing docs: rebrand volume names,
stale CSS vars, TLS_MODE env, self-hosted font notes, Architecture
frontend section.

Team Admin workflows.js (722 lines) split into 3 modules:
workflows.js (router+CRUD), workflow-editor.js (editor+stages),
workflow-monitor.js (assignments+monitor+signoff).

Fix: docs outline scroll no longer pushes topbar off-screen.
Fix: --bg-2 (undefined CSS var) replaced with --bg-secondary.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-02 13:49:00 +00:00

2.9 KiB

Raw Blame History

Getting Started

Prerequisites

Docker and Docker Compose

Running with Docker Compose

docker compose up --build

Open http://localhost:3000. Default credentials: admin / admin.

Data persists in the armature_data named volume. To reset everything:

docker compose down -v

First Boot

On first start, Armature will:

Run database migrations (SQLite by default in compose).
Create the admin user from ARMATURE_ADMIN_USERNAME / ARMATURE_ADMIN_PASSWORD env vars.
Auto-install the curated default package set (notes, chat-core, dashboard, workflow demos, etc.).

No manual setup steps are required.

Installing Additional Packages

The Docker image ships with extra packages beyond the default set. To install them:

Via Admin UI: Go to /admin > Packages. Browse, enable, or install packages.
Via environment variable: Set BUNDLED_PACKAGES before starting:

# Install all bundled packages
BUNDLED_PACKAGES="*" docker compose up --build

# Install specific extras
BUNDLED_PACKAGES="notes,tasks,schedules" docker compose up --build

You can also upload .pkg archives through the Admin > Packages page.

Key URLs

URL	Purpose
`/`	Redirects to your default surface
`/admin`	Admin panel (users, packages, settings, teams)
`/settings`	User settings (profile, preferences, default surface)
`/welcome`	Welcome page (shown when no surfaces are installed)
`/api/docs`	Interactive OpenAPI documentation

Key Environment Variables

Variable	Default	Description
`PORT`	`8080`	Backend API port
`DB_DRIVER`	auto	`postgres` or `sqlite`
`DATABASE_URL`		PostgreSQL DSN or SQLite file path
`JWT_SECRET`	`dev-secret-change-me`	Change in production
`ENCRYPTION_KEY`		AES-256 key for credential encryption
`AUTH_MODE`	`builtin`	`builtin`, `mtls`, or `oidc`
`STORAGE_BACKEND`	auto	`pvc` or `s3`
`STORAGE_PATH`	`/data/storage`	PVC mount point
`ARMATURE_ADMIN_USERNAME`		Bootstrap admin username
`ARMATURE_ADMIN_PASSWORD`		Bootstrap admin password
`BUNDLED_PACKAGES`	(empty)	`""` = curated defaults, `"*"` = all, or comma-separated IDs
`SKIP_BUNDLED_PACKAGES`	`false`	Disable auto-install entirely
`LOG_LEVEL`	`info`	`debug`, `info`, `warn`, `error`
`LOG_FORMAT`	`text`	`text` or `json`

From Source

git clone <repo-url> && cd armature
cp server/.env.example server/.env   # edit DB credentials
cd server && go run .
# Backend on http://localhost:8080

Next Steps

Extension Guide -- Author your own packages
API Reference -- REST API overview
Deployment -- Production deployment
Architecture -- System design

2.9 KiB Raw Blame History