1. Project Overview & Quickstart (getarcaneapp/arcane)

File: README.md

File: cli/README.md

Install

This module lives inside the main Arcane repo. To build the CLI locally:

go install github.com/getarcaneapp/arcane/cli/v2@latest

Versions

CLI versions are tagged as cli/vX.Y.Z in the main repo. Use module tags to pin a specific release:

go install github.com/getarcaneapp/arcane/cli/v2@cli/vX.Y.Z

Configure

The CLI stores config in ~/.config/arcanecli.yml.

Create a starter config file (all supported keys):

arcane config init
arcane config backup (moves current config to ~/.config/arcanecli.yml.bak)

Set the Arcane server URL:

arcane config set server-url http://localhost:3552

Authenticate (choose one)

Option A: Device code (OIDC must be enabled for this method, as it uses your external provider.)

arcane auth login

Option B: API key

arcane config set api-key arc_xxxxxxxxxxxxx

Useful Global Flags

--output text|json for output mode (--json is an alias for --output json)
--env to override the configured default environment for one command
--yes to auto-confirm destructive prompts
--no-color to disable ANSI color output
--request-timeout <duration> to override HTTP timeout per command

Utilities

arcane completion bash|zsh|fish|powershell to generate shell completions
arcane doctor to run local CLI diagnostics

Pagination Config

Set global and per-resource list limits in config:

yaml

pagination:
  default:
    limit: 25
  resources:
    containers:
      limit: 50
    images:
      limit: 100
    volumes:
      limit: 40
    networks:
      limit: 40

CLI precedence is:

--limit
pagination.resources.<resource>.limit
pagination.default.limit
command built-in default

You can configure limits with:

arcane config set default-limit 25
arcane config set pagination.resources.containers.limit 50 pagination.resources.images.limit 100

Legacy flag syntax remains supported:

arcane config set --default-limit 25
arcane config set --resource-limit containers=50 --resource-limit images=100

2. Official Technical Reference & Guides (getarcaneapp/website)

File: README.md

Arcane Documentation Website

This documentation site is built with SvelteKit and uses Vite+ for local development.

Developing

Once you've created a project and installed dependencies with vp install, start a development server:

bash

vp dev

PR Previews

Pull request previews are served on a custom pr-**.arcane.ofkm.workers.dev domain, The deployments use Wrangler and cloudflare workers.

File: content/changelog/2025.md

title: 'Changelog 2025'

v1.11.2 - 2025-12-28

Release

Backend - Bug fixes

use both legacy and new api key headers for agent authentication (#1271 by @kmendell)
button flex 'bouncy' layout issue(51977fc by @kmendell)
add generate command back to built in cli(875a96a by @kmendell)
correctly fetch dynamic image/container items on dashboard(7965948 by @kmendell)
allow literal quotes in oidc env values (#1272 by @kmendell)

Full Changelog: https://github.com/getarcaneapp/arcane/compare/v1.11.1...v1.11.2

v1.11.1 - 2025-12-27

Release

Backend - Bug fixes

api key validator not checking for user correctly for admin endpoints(dad577a by @kmendell)
oidc form incorrectly parsing numbers preventing saving (#1234 by @kmendell)
use png logo for emails instead of svg(c2948d5 by @kmendell)
make inline start/stop icons colored for better readability(18de25c by @kmendell)
dark/light mode not being respected on certain elements(b877daa by @kmendell)
editing a user fails to save due to validation error(4203424 by @kmendell)
change email encoding to quoted-printable (#1238 by @kmendell)
use correct data path and port in deployment snippets(cb4163d by @kmendell)
incorrect api-key validation(cfaf05f by @kmendell)
dashboard not pulling correct data on env switch(db53bb5 by @kmendell)
route matching for resource detail pages when switching environments(db552f5 by @kmendell)
env values being injected into all containers by default (#1250 by @kmendell)

CLI - Bug fixes

use proper timeouts for specific commands(267dd09 by @kmendell)
incorrect return type for settings response(e3c323b by @kmendell)

Dependencies

bump svelte from 5.46.0 to 5.46.1 (#1229 by @dependabot[bot])
bump @xterm/addon-fit from 0.10.0 to 0.11.0 (#1232 by @dependabot[bot])

Full Changelog: https://github.com/getarcaneapp/arcane/compare/v1.11.0...v1.11.1

v1.11.0 - 2025-12-24

Release

Backend - New features

gpu monitoring environment flags (#1034 by @mrtimothyduong)
new arcane info dialog(61ee1b8 by @kmendell)
add api key authentication (#1046 by @kmendell)
container update indicator directly in the table (#1077 by @kmendell)
inline start and stop functions for containers (#1079 by @kmendell)
show ports in project service overview panel(72298c4 by @kmendell)
dynamic oidc redirect url based on url origin (#1094 by @kmendell)
sort containers connected to a network (#1095 by @kmendell)
ability to toggle between the classic project and tree view ui (#1120 by @kmendell)
auto pairing and new agent creation flow (#1114 by @kmendell)
new environment switcher dialog (#1126 by @cabaucom376)
add ip address column and cell to container table (#1143 by @NeoCortex3)
only send notifications when new updates arrive (#1157 by @kmendell)
unified tooltip/popover component (#1125 by @cabaucom376)
show agent version in details overview(8377fac by @kmendell)
environment settings now are edited on the agent details page (#1206 by @kmendell)

CLI - New features

initial arcane-cli release (#1150 by @kmendell)

Backend - Bug fixes

do not run environment health job on agent(123a621 by @kmendell)
settings not allowing saving, and not updating immediately(86731e6 by @kmendell)
add redirect from /auth/oidc/callback to /oidc/callback(ef621bf by @kmendell)
missing tooltip providers causing lockups on mobile(8240e45 by @kmendell)
pagination controls missing when containers grouped by project(74c0be1 by @kmendell)
projects not being deleted on remote agents (#1047 by @kmendell)
update api url to APP_URL for local environment on each startup(96494c9 by @kmendell)
geist font not being applied(43fc48b by @kmendell)
data race on initial loading of settings/users(80a9bef by @kmendell)
bump github.com/quic-go/quic-go to 0.57.0 (#1117 by @dependabot[bot])
text selection color not able to be seen for terminal in light mode(a7bc358 by @kmendell)
unsafe state mutation for notification test button(4461315 by @kmendell)
locale picker not selecting language (#1148 by @cabaucom376)
status badge text overflow(b598d7d by @kmendell)
oidc merge accounts failing to lookup emails (#1154 by @kmendell)
only save apprise settings if they changed(aba7525 by @kmendell)
show all network attributes from docker api (#1171 by @kmendell)
glass not being applying on actions popover(9d64fd7 by @kmendell)
image pull progress not streaming from remote environments (#1175 by @kmendell)
improve Monaco IntelliSense based on compose spec (#1190 by @kmendell)
padding on bottom of other resource layouts(8a9960a by @kmendell)
settings state only allows one setting to be updated(56ad326 by @kmendell)
auto updater issues with certain network modes (#1205 by @kmendell)
mobile layout and performance issues(9816512 by @kmendell)
image update available notifications now being sent(9500c9d by @kmendell)

CLI - Bug fixes

move main.go to module root(024048b by @kmendell)

Backend - Performance improvements

add missing database indexes to improve slow sql queries (#1169 by @kmendell)

Dependencies

update dependabot configuration to weekly schedule and remove groups(a7f053a by @kmendell)
bump react from 19.2.0 to 19.2.1 (#1056 by @dependabot[bot])
bump react-dom from 19.2.0 to 19.2.1 (#1055 by @dependabot[bot])
bump prettier from 3.7.3 to 3.7.4 (#1057 by @dependabot[bot])
bump peter-evans/find-comment from 3 to 4 (#1084 by @dependabot[bot])
bump peter-evans/create-or-update-comment from 4 to 5 (#1083 by @dependabot[bot])
bump github.com/spf13/cobra from 1.10.1 to 1.10.2 in /backend (#1085 by @dependabot[bot])
bump runed to 0.37.0 (#1091 by @kmendell)
bump github.com/go-co-op/gocron/v2 from 2.18.2 to 2.19.0 in /backend (#1129 by @dependabot[bot])
bump golang.org/x/text from 0.31.0 to 0.32.0 in /backend (#1132 by @dependabot[bot])
bump golang.org/x/oauth2 from 0.33.0 to 0.34.0 in /backend (#1133 by @dependabot[bot])
bump actions/cache from 4 to 5 (#1127 by @dependabot[bot])
bump golang.org/x/crypto from 0.45.0 to 0.46.0 in /backend (#1130 by @dependabot[bot])
bump stefanzweifel/git-auto-commit-action from 5 to 7 (#1145 by @dependabot[bot])
bump actions/download-artifact from 6 to 7 (#1146 by @dependabot[bot])
bump actions/upload-artifact from 5 to 6 (#1144 by @dependabot[bot])
bump react-dom from 19.2.1 to 19.2.3 (#1137 by @dependabot[bot])
bump pnpm to version 10.26.0(872f23a by @kmendell)
bump github.com/goccy/go-yaml from 1.19.0 to 1.19.1 in /backend (#1188 by @dependabot[bot])
bump prettier-plugin-svelte from 3.4.0 to 3.4.1 (#1186 by @dependabot[bot])
bump github.com/docker/compose/v5 from 5.0.0 to 5.0.1 in /backend (#1189 by @dependabot[bot])
bump next in email templates, remove lezer/common override(d20cb3e by @kmendell)
bump @react-email/components from 1.0.1 to 1.0.2 (#1197 by @dependabot[bot])

Other

use go workspaces and svelte layout groups (#1049 by @kmendell)
use crowdin github action(0a85fef by @kmendell)
revert crowdin github action(f71af94 by @kmendell)
use huma to generate open api spec on top of gin (#1068 by @kmendell)
serve application fonts from the backend embedded fs (#1106 by @kmendell)
ui layout improvements and polish (#1102 by @kmendell)
fix settings sidebar styling in non-glass mode(21e2adb by @kmendell)
add cli binaries to release(851d08c by @kmendell)
remove deprecated onboarding types and logic (#1176 by @kmendell)
switch from code-mirror to monaco editor (#1123 by @kmendell)
ui layout and input tweaks and cleanup (#1194 by @kmendell)
split arcane table into multiple files (#1201 by @kmendell)

Full Changelog: https://github.com/getarcaneapp/arcane/compare/v1.10.1...v1.11.0

v1.10.1 - 2025-12-03

Release

Bug fixes

Pass project object to StartOptions (#1010 by @chadweimer)
dashboard memory stats not restrained to container limits(80ccc9b by @kmendell)
exposed ports woroding rework will show published/exposed or a mix of the two(ebee116 by @kmendell)
Tooltip.Provider not found causing env page to hang(3b3ff91 by @kmendell)
dashboard tables footer overlapping cells(305f46b by @kmendell)
bump validator to 13.15.22(9420308 by @kmendell)
arcane-table generic types(200f7ea by @kmendell)
use proper svelte reactivity logic to fix svelte-check warnings (#1042 by @kmendell)
set --primary-foreground as black in light mode(ff67565 by @kmendell)

Dependencies

bump pnpm from 10.22.0 to 10.24.0(f840fb4 by @kmendell)
bump node engine version requirement from >=24 to >=25(15a69ce by @kmendell)
bump the dev-dependencies group across 1 directory with 3 updates (#1028 by @dependabot[bot])
upgrade to compose v5 and compose-go v2.10.0(33b6704 by @kmendell)
bump the backend-dependencies group across 1 directory with 3 updates (#1037 by @dependabot[bot])
remove unused frontend dependencies(316df73 by @kmendell)

Other

update depot runner size(b2b3972 by @kmendell)
build next images sequentially(cde4d8b by @kmendell)
build frontend for next images(af53ba7 by @kmendell)
build all binaries for next images(bc69eed by @kmendell)
build armv7 containers for next image(5d1f0d6 by @kmendell)
use sequential workflow and single binary command(826ecd3 by @kmendell)
simplify release workflow to single sequential job(f1e942a by @kmendell)

Full Changelog: https://github.com/getarcaneapp/arcane/compare/v1.10.0...v1.10.1

v1.10.0 - 2025-11-30

Release

New features

support for include compose directive (eced698 by @user00265)
add version label to the login page(6d16da2 by @kmendell)
expand system info dialog to show more information (#965 by @kmendell)
add support for auto-starting of logs (#983 by @Juoper)
improved pull ui including layer progress (#1002 by @kmendell)
self update digest tracking and fixes (#919 by @cabaucom376)

Bug fixes

dashboard tables height cutting off rows(10f0d85 by @kmendell)
pass registry credentials to environment (d7a112a by @cabaucom376)
use dynamic limit for dashboard tables on page refreshes(f0be4d2 by @kmendell)
image name container table overflow(3675cca by @kmendell)
use correct PWD env variable (#941 by @kmendell)
dashboard showing incorrect memory value(d49be99 by @kmendell)
redirect to root resource page when switching environments(223d5b4 by @kmendell)
notification settings not able to be saved due to incorrect key(4cd7ff5 by @kmendell)
dont sort global env alphabetically(cbca27b by @kmendell)
conflicting options: hostname and the network mode for auto update runs(f267dce by @kmendell)
oidc settings not saving after changing other security settings (#1003 by @kmendell)

Performance Improvements

overall performance improvements and db transactions (#951 by @kmendell)

Dependencies

bump the prod-dependencies group with 4 updates (0e3896c by @dependabot[bot])
upgrade to node 25 for frontend builds (85beddf by @kmendell)
bump pnpm to version 10.22.0(394fd2e by @kmendell)
bump golang.org/x/crypto from 0.44.0 to 0.45.0 in /backend in the backend-dependencies group (#954 by @dependabot[bot])
bump actions/checkout from 5 to 6 (#957 by @dependabot[bot])
bump github.com/coreos/go-oidc/v3 from 3.16.0 to 3.17.0 in /backend in the backend-dependencies group (#973 by @dependabot[bot])
bump github.com/go-co-op/gocron/v2 from 2.18.0 to 2.18.1 in /backend in the backend-dependencies group (#978 by @dependabot[bot])
bump github.com/go-co-op/gocron/v2 from 2.18.1 to 2.18.2 in /backend in the backend-dependencies group (#992 by @dependabot[bot])
bump valibot to 1.2.0(040e741 by @kmendell)
bump prettier from 3.6.2 to 3.7.1 in the dev-dependencies group (#996 by @dependabot[bot])

Other

update depot runners(7f5461e by @kmendell)
use constant type for config values(e13c3c7 by @kmendell)
use constant for index.html(ba69bfd by @kmendell)
use constant errors to reduce duplication (#964 by @kmendell)
use Debian Trixie for container builds/runtime (#975 by @kmendell)
add sonarqube analysis(9cd9c49 by @kmendell)
add coverage report to sonarqube(219cd8c by @kmendell)
rewrite go coverage report(08f5fee by @kmendell)
update analytics job to use new domain(7e8c02f by @kmendell)
remove sonarqube workflows(69eb206 by @kmendell)
update library used for image referencing (#1007 by @kmendell)
fix next release logic(d14a051 by @kmendell)
fix next release logic(88711f3 by @kmendell)
fix next release logic(ae40aec by @kmendell)
use field group components for specific pages(a01787b by @kmendell)

Full Changelog: https://github.com/getarcaneapp/arcane/compare/v1.9.0...v1.10.0

v1.9.0 - 2025-11-16

Release

New features

apprise notifications support (#899 by @kmendell)
add gpu monitoring (#799 by @mrtimothyduong)
support uploading local docker images (#902 by @kmendell)
edit environments and show/edit local environment (#915 by @cabaucom376)
add refresh button to project action buttons(4e5dcf4 by @kmendell)

Bug fixes

check for image locally before pulling when deploying project(7269ece by @kmendell)
show popover when project name is missing for better user UX(f77044e by @kmendell)
separate prefefined networks from the rest in usage count(313bbbd by @kmendell)
environment switcher not showing added or removed items without refresh(34c1ddc by @kmendell)
environment data initialization on refreshes (#925 by @cabaucom376)
missing tooltip provider (#927 by @cabaucom376)
show correct stats based on cgroup restrictions (#923 by @kmendell)
properly assign inUse status to volume return data(71623e3 by @kmendell)
max depth control for project watcher (#928 by @kmendell)

Dependencies

bump the backend-dependencies group in /backend with 2 updates (#882 by @dependabot[bot])
bump the prod-dependencies group with 3 updates (#881 by @dependabot[bot])
bump pnpm to 10.21.0(fb63171 by @kmendell)
bump cookie to 0.7.0(4a90b2b by @kmendell)
bump the prod-dependencies group with 4 updates (#900 by @dependabot[bot])
bump the prod-dependencies group with 2 updates (#920 by @dependabot[bot])
bump actions/download-artifact from 5 to 6 (#929 by @dependabot[bot])

Other

refactor next image workflow(f5c3fca by @kmendell)
use upload-artifact v5(ef12e17 by @kmendell)
use go cache path(48e4cc6 by @kmendell)
workflow refactors and tweaks(d8f8d53 by @kmendell)
use github oidc for depot in release workflow(c2764db by @kmendell)

Full Changelog: https://github.com/getarcaneapp/arcane/compare/v1.8.1...v1.9.0

v1.8.1 - 2025-11-10

Release

Bug fixes

null checks for tag arrays in template viewer(55c592e by @kmendell)
template details page now loading when no env is found(b7203ce by @kmendell)
header showing background in non-glass ui mode(d4811f1 by @kmendell)
individual image update checks not using credentials(64cd997 by @kmendell)
normzalize project name on load(754b426 by @kmendell)
discord notifications unable to be saved due to zod validations(fae1c94 by @kmendell)
clear notification values from database is disabled(b8d10c9 by @kmendell)
remove entrypoint to fix file permission issues (#879 by @kmendell)
tooltip showing on env switcher in sidebar hover mode(757baf6 by @kmendell)

Dependencies

bump golangci/golangci-lint-action from 8 to 9 (#872 by @dependabot[bot])

Full Changelog: https://github.com/getarcaneapp/arcane/compare/v1.8.0...v1.8.1

v1.8.0 - 2025-11-07

Release

[!IMPORTANT]
The docker images have changed to ghcr.io/getarcaneapp/arcane and ghcr.io/getarcaneapp/arcane-headless for all releases going forward.

New features

show image repo on untagged images (#809 by @kmendell)
save compose files to local templates (#834 by @cabaucom376)
merge oidc users with existing users toggle (#860 by @kmendell)

Bug fixes

pass version to docker file builds(c28abd4 by @kmendell)
syntax highlighting not showing on code-editors(ab03008 by @kmendell)
show ansi colors in log viewer(a6be63d by @kmendell)
status badges not reactive to states(88fb669 by @kmendell)
unable to create ipvlan or macvlan networks(5f4e9e0 by @kmendell)
unpinned sidebar overflow scrolling in non-expanded state (#831 by @cabaucom376)
volumes not removed when selected on container removal dialog(bb928fe by @kmendell)
use proper derived logic for status baddge(e0d66b5 by @kmendell)

Dependencies

update module github.com/compose-spec/compose-go/v2 to v2.9.1 (#810 by @renovate[bot])
update module github.com/docker/compose/v2 to v2.40.3 (#811 by @renovate[bot])
update dependency svelte to v5.43.1 (#814 by @renovate[bot])
update dependency eslint-plugin-svelte to v3.13.0 (#813 by @renovate[bot])
update dependency svelte to v5.43.2 (#816 by @renovate[bot])
update dependency @sveltejs/kit to v2.48.4 (#819 by @renovate[bot])
update module github.com/shirou/gopsutil/v4 to v4.25.10 (#827 by @renovate[bot])
update dependency @lucide/svelte to ^0.552.0 (#822 by @renovate[bot])
update dependency bits-ui to v2.14.2 (#826 by @renovate[bot])
update dependency globals to v16.5.0 (#828 by @renovate[bot])
update eslint monorepo to v9.39.0 (#825 by @renovate[bot])
update dependency isomorphic-dompurify to v2.31.0 (#832 by @renovate[bot])
update module gorm.io/gorm to v1.31.1 (#833 by @renovate[bot])
update dependency typescript-eslint to v8.46.3 (#840 by @renovate[bot])
update dependency svelte to v5.43.3 (#843 by @renovate[bot])
update dependency @codemirror/lint to v6.9.2 (#838 by @renovate[bot])
update eslint monorepo to v9.39.1 (#841 by @renovate[bot])
update dependency @types/node to v24.10.0 (#836 by @renovate[bot])
update dependency axios to v1.13.2 (#844 by @renovate[bot])
update dependency @uiw/codemirror-theme-github to v4.25.3 (#846 by @renovate[bot])
update dependency @uiw/codemirror-themes to v4.25.3 (#847 by @renovate[bot])
update dependency vite to v7.2.0 (#849 by @renovate[bot])
update dependency sveltekit-superforms to v2.28.1 (#848 by @renovate[bot])
update dependency svelte to v5.43.4 (#858 by @renovate[bot])
bump github.com/containerd/containerd/v2 from 2.1.4 to 2.1.5 in /backend in the go_modules group across 1 directory (#857 by @dependabot[bot])
update dependency vite to v7.2.1 (#854 by @renovate[bot])
update module github.com/docker/docker to v28.5.2+incompatible (#852 by @renovate[bot])
update module github.com/docker/cli to v28.5.2+incompatible (#851 by @renovate[bot])
update module github.com/go-co-op/gocron/v2 to v2.18.0 (#853 by @renovate[bot])
update tailwindcss monorepo to v4.1.17 (#859 by @renovate[bot])
update dependency vite to v7.2.2 (#864 by @renovate[bot])
update dependency @lucide/svelte to ^0.553.0 (#865 by @renovate[bot])
update dependency react-email to v5 (#868 by @renovate[bot])
update dependency @react-email/preview-server to v5 (#867 by @renovate[bot])
update dependency @react-email/components to v1 (#866 by @renovate[bot])
update dependency vite to v7.2.2 (#869 by @renovate[bot])

Other

responsive create container dialog (#830 by @cabaucom376)
use depot builders and images(2bb159d by @kmendell)
fix typo in image name(2e49791 by @kmendell)
build e2e tests image with depot(52aaac4 by @kmendell)
use depot token(6ad13a3 by @kmendell)
remove double outputs(3a619d0 by @kmendell)
use depot registry(0cebb42 by @kmendell)
use depot token for all builds(65601d5 by @kmendell)
use go cache from depot(e83c717 by @kmendell)
revert depot usage for some workflows(fd369d1 by @kmendell)
extended dashboard tables (#871 by @kmendell)

Full Changelog: https://github.com/getarcaneapp/arcane/compare/v1.7.2...v1.8.0

v1.7.2 - 2025-10-30

Release

Bug fixes

syntax highlighting not showing on code-editors(027155e by @kmendell)
pass version to docker file builds(8a136cd by @kmendell)

Full Changelog: https://github.com/ofkm/arcane/compare/v1.7.1...v1.7.2

v1.7.1 - 2025-10-30

Release

Bug fixes

mobile overscroll issues(fa0a7d2 by @kmendell)
use correct background colors for components when glass is disabled(615c21f by @kmendell)
event details dialog header padding(55dca66 by @kmendell)
cpu count not showing under cpu meter(30cab56 by @kmendell)
settings state not persisted across settings pages(46bbe93 by @kmendell)
notification settings does not show on the settings overview page(6354f9c by @kmendell)
properly log error events to event table(caef210 by @kmendell)

Other

bump svelte from 5.42.3 to 5.43.0 in the prod-dependencies group (#796 by @dependabot[bot])
bump @types/node from 24.9.1 to 24.9.2 in the dev-dependencies group (#797 by @dependabot[bot])
Configure Renovate (#803 by @renovate[bot])
remove dependabot config(019f3d6 by @kmendell)
update renovate config to include semantic commit type for chores(a2f24ce by @kmendell)
disable renovate dashboard(dc79404 by @kmendell)
update dependency @sveltejs/kit to v2.48.3 (#802 by @renovate[bot])
update dependency @eslint/compat to v1.4.1 (#801 by @renovate[bot])
upgrade github.com/shirou/gopsutil to v4(57fa42c by @kmendell)
layout and design of docker info dialog(3004447 by @kmendell)
use SettingsForm hook for managing settings logic and state(e09a808 by @kmendell)
fix backend linter(d36f6ad by @kmendell)

Full Changelog: https://github.com/ofkm/arcane/compare/v1.7.0...v1.7.1

v1.7.0 - 2025-10-29

Release

New features

arcane-cli generate secret command (#760 by @kmendell)
notification system for container and image updates (#730 by @kmendell)
add hostname to dashboard(492222d by @kmendell)
arcane self-updater (#744 by @kmendell)

Bug fixes

text inputs not using correct string or number type for input boxes(215d8ed by @kmendell)
project env interpolation not parsing env files in correct order (#751 by @kmendell)
load project services concurrently (#758 by @kmendell)
only log entrypoint when running the base arcane-cli command(e95093f by @kmendell)
refresh environment on all pages(44501d4 by @kmendell)
properly persist local vs environment settings (#775 by @kmendell)
remove default route from customize overview (#776 by @cabaucom376)
responsive dialog overflow (#786 by @cabaucom376)
scroll-to-hide by mode, fix detachment (#781 by @cabaucom376)
containers unable to be sorted by name(f1905ed by @kmendell)
stat card columns(ac05b46 by @kmendell)
date locale cant be loaded from date-fns if locale is en(947655c by @kmendell)
popovers fully transparent without glassmorphism (#793 by @cabaucom376)
encryption key validation errors(b3c7cb5 by @kmendell)
sessions not using refresh tokens (#795 by @kmendell)

Other

bump the dev-dependencies group with 3 updates (#743 by @dependabot[bot])
bump github.com/docker/compose/v2 from 2.40.0 to 2.40.1 in /backend in the backend-dependencies group (#745 by @dependabot[bot])
bump the prod-dependencies group with 6 updates (#742 by @dependabot[bot])
use ellipsis instead of three dots in source strings (#748 by @blfpd)
use ellipsis instead of three dots in translated strings (#749 by @blfpd)
add greptile.json configuration file(7e3c645 by @kmendell)
bump vite from 7.1.10 to 7.1.11 in the npm_and_yarn group across 1 directory (#752 by @dependabot[bot])
move settings/customize search to backend (#739 by @kmendell)
bump @types/node from 24.8.1 to 24.9.1 in the dev-dependencies group (#754 by @dependabot[bot])
bump the prod-dependencies group with 4 updates (#753 by @dependabot[bot])
fix linter about complexity(bc99f5a by @kmendell)
remove onboarding screens with simple change password dialog (#759 by @kmendell)
bump isomorphic-dompurify from 2.29.0 to 2.30.0 in the prod-dependencies group (#761 by @dependabot[bot])
bump pnpm to 10.19.0(7046e7e by @kmendell)
show correct version on non-release builds(d0b6b35 by @kmendell)
pass version arguments to next build(be7222a by @kmendell)
bump frontend and tests pnpm version to 10.19.0(a441293 by @kmendell)
tweak glass-ui styling(f6edd50 by @kmendell)
bump vite from 7.1.11 to 7.1.12 in the dev-dependencies group (#769 by @dependabot[bot])
bump the prod-dependencies group across 1 directory with 9 updates (#774 by @dependabot[bot])
tweak glass ui on sheets and dialogs(051fee6 by @kmendell)
update backend deps(7de538c by @kmendell)
use env interpolation in project tests(7ba22ce by @kmendell)
use correct project logs heading selector(2742223 by @kmendell)
use correct project logs button selectors(dbecb46 by @kmendell)
use drawers on mobile and dialogs on desktop(89beadc by @kmendell)
better align glass ui in production builds(ed9b171 by @kmendell)
login screen styling (#780 by @cabaucom376)
bump the prod-dependencies group with 4 updates (#784 by @dependabot[bot])
bump actions/upload-artifact from 4 to 5 (#782 by @dependabot[bot])
bump actions/download-artifact from 5 to 6 (#783 by @dependabot[bot])
update dialog overflow (#788 by @cabaucom376)
use accent color for card header (#789 by @cabaucom376)
table styling (#787 by @cabaucom376)
run formatter(a89581e by @kmendell)
restore solid backgrounds for non-glass ui(38f919b by @kmendell)
use dropdown card component for group by project(b26f873 by @kmendell)
use new ubuntu-slim runner for smaller workflows(51213a4 by @kmendell)
revert ubuntu-slim workflows(6ead191 by @kmendell)
bump validator.js to 13.15.20(db216dd by @kmendell)
bump pnpm to 10.20.0(5241be7 by @kmendell)
table cell newline wrapping fix (#792 by @cabaucom376)
bump the prod-dependencies group across 1 directory with 6 updates (#794 by @dependabot[bot])
bump @types/dockerode from 3.3.44 to 3.3.45 in the dev-dependencies group (#785 by @dependabot[bot])
change upgrader image tag to 'latest'(882edae by @kmendell)

Full Changelog: https://github.com/ofkm/arcane/compare/v1.6.0...v1.7.0

v1.6.0 - 2025-10-19

Release

New features

redeisgned templates pages (#648 by @cabaucom376)
show project status reason (#708 by @kmendell)
configurable hover and pinned states for sidebar (#720 by @kmendell)
add glass effect ui preview (disabled by default) (#733 by @kmendell)

Bug fixes

mobile navigation glitches and scrolling issues (#709 by @kmendell)
show users full name instead of username in mobile user card(0086f31 by @kmendell)
display toast at the top on mobile and tablet devices(80decef by @kmendell)
save button showing behind mobile nav bar(574e22c by @kmendell)
environment hostname text showing under select input on mobile sheet(ac0f1fa by @kmendell)
card headers not reactive to mode-watchers theme(6aad161 by @kmendell)
display full image sha256 on image details page(2f0bab5 by @kmendell)
show customization sub routes in mobile navigation(07713ce by @kmendell)
mobile nav sheet not working on small desktop screens(14bd338 by @kmendell)
velocity to open nav sheet in mobile view(3d436a1 by @kmendell)
sub nav items now showing in hover mode(c60e954 by @kmendell)
include version in jwt for auth sessions after updating the server (#724 by @kmendell)
update file permissions to 0644 for project and template file creations(ca66f44 by @kmendell)
handle Docker socket GID conflict in entrypoint (#735 by @jae-jae)
hidden table columns data still showing even if the column is hidden(aced2a6 by @kmendell)
update icon import (#737 by @cabaucom376)
z-index of search icons on settings and customize pages(87af81c by @kmendell)
sidebar items not expanding in non hover mode(515d442 by @kmendell)

Other

add Deutsch files(31dfa46 by @kmendell)
bump github.com/go-co-op/gocron/v2 from 2.16.6 to 2.17.0 in /backend in the backend-dependencies group (#701 by @dependabot[bot])
bump the prod-dependencies group with 3 updates (#699 by @dependabot[bot])
bump @types/node from 24.7.1 to 24.7.2 in the dev-dependencies group (#700 by @dependabot[bot])
restructure scripts directory(9cd3333 by @kmendell)
service worker caching tweaks(86057f1 by @kmendell)
update runner tags(c04af97 by @kmendell)
upgrade deps(614130a by @kmendell)
remove docker build cloud from ci/cd(3063dc1 by @kmendell)
pin runed to 0.34.0(2946ad7 by @kmendell)
fix linter(d6290b6 by @kmendell)
fix after last merge(4a73728 by @kmendell)
bump the dev-dependencies group with 2 updates (#716 by @dependabot[bot])
bump the prod-dependencies group across 1 directory with 3 updates (#717 by @dependabot[bot])
pin setup-node to latest commit hash of v5(4851729 by @kmendell)
bump sveltekit-superforms from 2.27.3 to 2.27.4 in the npm_and_yarn group across 1 directory (#719 by @dependabot[bot])
consolidate build next workflows using matrix(5e4229b by @kmendell)
build next images one after another(d06ec48 by @kmendell)
use ubuntu-latest for workflow builds(e2e62b6 by @kmendell)
unify project, env, and template file writing logic (#725 by @kmendell)
bump the dev-dependencies group with 2 updates (#728 by @dependabot[bot])
bump the prod-dependencies group with 5 updates (#727 by @dependabot[bot])
replace custom sheet with drawer component (#726 by @kmendell)
tweak dockerfile(e640439 by @kmendell)

Full Changelog: https://github.com/ofkm/arcane/compare/v1.5.2...v1.6.0

v1.5.2 - 2025-10-13

Release

Bug fixes

remove custom timestamps and rely solely on dockers log timestamps(c69e00a by @kmendell)
container metrics not respecting the cpu limit / count(f9840de by @kmendell)
registry credentials not reliably being passed to remote environments(31cfd54 by @kmendell)
revert development compose deploy limits (#697 by @cabaucom376)
update registry template url to new domain(1ee3f1c by @kmendell)

Performance Improvements

use service-worker and better caching headers to better manage cache problems after updates(3200b39 by @kmendell)

Other

fix go import check(fd2a50b by @kmendell)

Full Changelog: https://github.com/ofkm/arcane/compare/v1.5.1...v1.5.2

v1.5.1 - 2025-10-12

Release

Bug fixes

do not log _app directory(a9efa58 by @kmendell)
selected environment id not persisting across refreshes(d87db5b by @kmendell)
accent color not reset after settings form reset(99fb83d by @kmendell)
project -> service back button not returning to project page(cbb6faa by @kmendell)
rework project redeploy logic to use compose pull & compose up -d(a5e377b by @kmendell)
use project/container name in action toast messages(3a7ea34 by @kmendell)
use accent color for code editor highlighter(ee6a0ad by @kmendell)
proper light and dark modes for container terminal(5c624c1 by @kmendell)
tail container and project logs properly on all ws hubs(b861c19 by @kmendell)
show exposed non published ports for containers(1dcc8b2 by @kmendell)
log viewer column layout duplicating timestamps, and un-needed scrollbars(3a1aeb5 by @kmendell)
volumes not showing containers they are being used by(6eac860 by @kmendell)
cache diskUsagePath setting to stop repeated database calls(4cd637b by @kmendell)

Other

use parent layout settings to avoid duplicate api calls(fb89650 by @kmendell)
bump to 10.18.2(8812a58 by @kmendell)
run formatter(57300b9 by @kmendell)

Full Changelog: https://github.com/ofkm/arcane/compare/v1.5.0...v1.5.1

v1.5.0 - 2025-10-11

Release

New features

docker socket proxy support via environment variable (#616 by @kmendell)
configurable disk usage path (#650 by @kmendell)
health status on project service card (#658 by @kmendell)
customizable accent color (#678 by @kmendell)
allow filtering events by severity(65c7c75 by @kmendell)
show volume size in table (#685 by @kmendell)

Bug fixes

remove tag based update logic and only use digests (#627 by @kmendell)
allow both pkce and plain auth challenges(fb4ac74 by @kmendell)
use 'up' and 'down' labels for project table actions(e9d8d38 by @kmendell)
use proper --all filter for volume pruning(734015b by @kmendell)
use correct response messages for container registry test (#665 by @kmendell)
memory leak in websocket connections (#664 by @kmendell)
default shell not able to be overridden(2d65952 by @kmendell)
unable to set global env when ui config is disabled(dfb9192 by @kmendell)
project editor height on project creation page(7d1ff5b by @kmendell)
add proper borders to event stat cards(4523985 by @kmendell)

Other

fix ES translations (#630 by @vsc55)
bump the backend-dependencies group in /backend with 2 updates (#646 by @dependabot[bot])
move compose examples to separate folder(aab7d3a by @kmendell)
update readme note(8f32754 by @kmendell)
bump the prod-dependencies group with 4 updates (#644 by @dependabot[bot])
bump eslint from 9.36.0 to 9.37.0 in the dev-dependencies group (#645 by @dependabot[bot])
ensure proper handling of contexts and spec (#647 by @kmendell)
cleanup and simplify application bootstrap (#651 by @kmendell)
bump the prod-dependencies group with 4 updates (#654 by @dependabot[bot])
fix logic with e2e tests caching(f910e39 by @kmendell)
use up and down selectors(d3d0607 by @kmendell)
bump the dev-dependencies group with 2 updates (#655 by @dependabot[bot])
bump the prod-dependencies group with 3 updates (#660 by @dependabot[bot])
fix internal response of challenge manager(3d7187d by @kmendell)
update readme with new logo(4b34d0c by @kmendell)
serve images from backend vs static frontend assets (#671 by @kmendell)
bump the backend-dependencies group in /backend with 4 updates (#667 by @dependabot[bot])
bump the prod-dependencies group with 3 updates (#666 by @dependabot[bot])
bump @types/node from 24.7.0 to 24.7.1 in the dev-dependencies group (#672 by @dependabot[bot])
update pwa assets (#673 by @kmendell)
use docker build cloud(01a6dc2 by @kmendell)
add docker build cloud for release and e2e tests(7a981ce by @kmendell)
remove docker build cloud for e2e tests(2675285 by @kmendell)
improve types on loading indicator(2118d6f by @kmendell)
use root page for /customize route (#675 by @kmendell)
use new empty component(dad95bc by @kmendell)
use shadcn spinner component (#676 by @kmendell)
update global variable input design(87f60d6 by @kmendell)
bump github.com/quic-go/quic-go from 0.54.0 to 0.54.1 in /backend in the go_modules group across 1 directory (#679 by @dependabot[bot])
cleanup svelte components (#681 by @kmendell)
remove stat cards from users page(bfcfc84 by @kmendell)
simplify stat card(319557e by @kmendell)
skip volume test if no inuse volumes(324edbf by @kmendell)

Full Changelog: https://github.com/ofkm/arcane/compare/v1.4.0...v1.5.0

v1.4.0 - 2025-10-05

Release

New features

interactive shell access to containers (#611 by @kmendell )
container stats websocket, and overhaul (#612 by @kmendell)
configure settings on environments via the web ui (#613 by @kmendell)
global compose and env defaults configuration (#617 by @kmendell)
global environment variables (#620 by @cabaucom376)
mobile responsive tables (#597 by @cabaucom376)
option to group containers by project (#625 by @cabaucom376)

Bug fixes

remove trailing slashing for all resource links(1d2e41c by @kmendell)
only show docker / general settings on environment page(57cff79 by @kmendell)
add missing context(ba4d20b by @kmendell)

Other

fix locators for container tests(10edce8 by @kmendell)
bump the prod-dependencies group with 4 updates (#614 by @dependabot[bot])
update readme screenshot(a18e3c0 by @kmendell)
bump the backend-dependencies group in /backend with 2 updates (#623 by @dependabot[bot])
bump the prod-dependencies group with 4 updates (#622 by @dependabot[bot])
bump the dev-dependencies group across 1 directory with 2 updates (#621 by @dependabot[bot])

Full Changelog: https://github.com/ofkm/arcane/compare/v1.3.0...v1.4.0

v1.3.0 - 2025-10-01

Release

New features

mobile navigation (#537 by @cabaucom376)
redesigned dashboard stats and docker info cards (#607 by @kmendell)

Bug fixes

correct display of user label in event details (#563 by @neilsb)
use display: fullscreen for app.webmanifest(d711d44 by @kmendell)
refresh container list when environment changes (#573 by @neilsb)
environment handler not registering correctly(05a1806 by @kmendell)
remove unused argument for environment handler(b3effbb by @kmendell)
add work directory and config files labels to projects(1c25aa8 by @kmendell)
properly align login screen elements when only oidc is enabled(4aeb845 by @kmendell)
sort and filter properly using docker api (#593 by @kmendell)
project title not saving(fe4e8b4 by @kmendell)
use live project status vs stored value(1426374 by @kmendell)
image update item not retrieving the correct update data(d6c449c by @kmendell)
skip onboarding when UI configuration is disabled (#602 by @kmendell)
pass registry credentials to environments (#603 by @kmendell)
remove trailing slash on projectId route(f824aa4 by @kmendell)
use correct destructive variant for registry delete item(cd4a49b by @kmendell)
use correct status badge for container registry table(9fdbe02 by @kmendell)
restrict docker dialog to screen bounds(2f74a3e by @kmendell)

Other

bump @playwright/test from 1.55.0 to 1.55.1 in the dev-dependencies group (#560 by @dependabot[bot])
bump the prod-dependencies group across 1 directory with 5 updates (#565 by @dependabot[bot])
bump github.com/go-co-op/gocron/v2 from 2.16.5 to 2.16.6 in /backend in the backend-dependencies group (#570 by @dependabot[bot])
generalize environment routes into individual handlers (#568 by @kmendell)
non env endpoints registered before env middleware (#580 by @kmendell)
bump the prod-dependencies group across 1 directory with 5 updates (#577 by @dependabot[bot])
use coreos/go-oidc library for oidc auth(80317bb by @kmendell)
add APP_URL to .env.dev(17738b1 by @kmendell)
improve ui consistency and maintainability (#582 by @cabaucom376)
bump @codemirror/view from 6.38.3 to 6.38.4 in the prod-dependencies group (#594 by @dependabot[bot])
update package manager to 10.17.1(6b287e8 by @kmendell)
add CODEOWNERS(c621fab by @kmendell)
tweak the styling of resource detail pages (#595 by @cabaucom376)
enhance the development pipeline by incorporating caching and troubleshooting tools (#596 by @cabaucom376)
bump typescript-eslint from 8.44.1 to 8.45.0 in the prod-dependencies group (#599 by @dependabot[bot])
bump @types/node from 24.5.2 to 24.6.0 in the dev-dependencies group (#598 by @dependabot[bot])
bump the dev-dependencies group with 2 updates (#606 by @dependabot[bot])
bump the prod-dependencies group with 3 updates (#605 by @dependabot[bot])

Full Changelog: https://github.com/ofkm/arcane/compare/v1.2.2...v1.3.0

v1.2.2 - 2025-09-24

Release

Bug fixes

container registry test connection not checking the correct endpoint(9d2c251 by @kmendell)
project save button not the correct size(7872080 by @kmendell)
use correct headers and cors values for websockets (#553 by @kmendell)
remove project updater logic, prune images after updating (#556 by @kmendell)
don't override env vars with default settings (#558 by @kmendell)
use correct json body for system prune(13e35fd by @kmendell)

Performance Improvements

optimize dockerfile(f2e8bd3 by @kmendell)

Other

add pull request title validation(e129344 by @kmendell)
add recommended extensions(539e00b by @kmendell)
.github/workflows: Migrate workflows to Blacksmith runners (#555 by @blacksmith-sh[bot])
extract digest retrieval logic into a separate function(5b012ff by @kmendell)
remove blacksmith runners(0b4fee5 by @kmendell)
fix go linter(274cb4a by @kmendell)
ignore linter on init function(b3d5974 by @kmendell)

Full Changelog: https://github.com/ofkm/arcane/compare/v1.2.1...v1.2.2

v1.2.1 - 2025-09-23

Release

Bug fixes

use correct settings return type(02db09a by @kmendell)
use correct running container count in dashboard metric(98a9cfa by @kmendell)
show correct stats for remote environments on dashboard (#549 by @kmendell)

Dependencies

bump the backend-dependencies group in /backend with 3 updates (#540 by @dependabot[bot])
bump the prod-dependencies group with 6 updates (#548 by @dependabot[bot])

Other

fix changelog with correct information(f20de40 by @kmendell)
bump the prod-dependencies group with 6 updates (#538 by @dependabot[bot])
bump the dev-dependencies group across 1 directory with 3 updates (#545 by @dependabot[bot])
add concurrency settings to E2E tests workflow(fe7ee76 by @kmendell)

Full Changelog: https://github.com/ofkm/arcane/compare/v1.2.0...v1.2.1

v1.2.0 - 2025-09-21

Release

New features

analytics plugin for number of instances (#483 by @kmendell)
use websockets for streaming logs (#495 by @kmendell)
use websockets for dashboard stats (#496 by @kmendell)
add pull progress popover when deploying project (#512 by @kmendell)
add build cache checkbox to prune dialog(5db08fc by @kmendell)
screen responsive navigation (#516 by @cabaucom376)
redesigned projects page (#464 by @kmendell)
settings page ui refresh (#518 by @cabaucom376)
ui configuration from env variables (#526 by @kmendell)
support PWA icons (#529 by @cabaucom376)

Bug fixes

update default admin user printed in logs, also print the default admin password on first run(5d3a66c by @kmendell)
update network usage detection to account for networks in use(4170985 by @kmendell)
use distribution reference for image digests (#484 by @kmendell)
load working directory before dotenv for projects(232d62e by @kmendell)
correctly validate and parse compose projects on load (#492 by @kmendell)
reload interface when switching environments(53c0aa4 by @kmendell)
dashboard not showing remote environment information(3a7b858 by @kmendell)
image polling value allows any number (#501 by @kmendell)
password change not being accepted by the backend(e82b114 by @kmendell)
use better wording on project action buttons and redploy dialog(bb25ac2 by @kmendell)
only watch env or compose files in filesystem watcher job(c957681 by @kmendell)
templates wouldnt allow empty files to be loaded in the ui(33b8303 by @kmendell)
use projectId for saving instead of projectName(1cb7ab2 by @kmendell)
ignore root files in template directory(637460a by @kmendell)
minor styling issue (#528 by @cabaucom376)
dont skip .env resolution(d8af378 by @kmendell)

Performance Improvements

improve websocket logs performance (#534 by @kmendell)

Dependencies

bump the prod-dependencies group with 4 updates (#480 by @dependabot[bot])
bump the backend-dependencies group across 1 directory with 2 updates(ec7e6cb by @dependabot[bot])
bump the backend-dependencies group across 1 directory with 2 updates (#485 by @dependabot[bot])
bump the prod-dependencies group with 7 updates (#522 by @dependabot[bot])

Other

add service unit tests(99e8a68 by @kmendell)
fix lints in tests(d3d50fb by @kmendell)
move the app version check to the backend (#473 by @kmendell)
inject default http client into services(441f8a4 by @kmendell)
make helper in loading projects(694607c by @kmendell)
bump @types/node in the dev-dependencies group(e9f2f74 by @dependabot[bot])
bump @types/node from 24.3.1 to 24.4.0 in the dev-dependencies group (#481 by @dependabot[bot])
use correct analytics host(c44aaec by @kmendell)
bump @types/node from 24.4.0 to 24.5.0 in the dev-dependencies group (#494 by @dependabot[bot])
bump the prod-dependencies group across 1 directory with 3 updates (#499 by @dependabot[bot])
add download docker script(d61d12a by @kmendell)
use compose-go for project related functions (#508 by @kmendell)
add ARG TARGETARCH back to static docker files(86e799f by @kmendell)
bump the prod-dependencies group with 3 updates (#504 by @dependabot[bot])
container-based development workflow with hot reload and VS Code integration (#509 by @cabaucom376)
cleanup go module(932824c by @kmendell)
Auto close VSCode terminals when tasks are finished (#511 by @cabaucom376)
include version in changelog(80fd46e by @kmendell)
use local build for arcane-agent(f9a962e by @kmendell)
split logic for stats ws(d43a256 by @kmendell)
bump svelte from 5.38.10 to 5.39.1 in the prod-dependencies group (#513 by @dependabot[bot])
bump the dev-dependencies group with 2 updates (#505 by @dependabot[bot])
add merge conflict labeler action(04a6c2b by @kmendell)
simplify filesystem watcher(ae159f9 by @kmendell)
cleanup sidebar translation keys(b5615c4 by @kmendell)
fix updated sidebar text(2440475 by @kmendell)
update projects header to new key(4912746 by @kmendell)
bump vite from 7.1.5 to 7.1.6 in the dev-dependencies group (#521 by @dependabot[bot])
cleanup template service (#523 by @kmendell)
remove dead and unused code (#525 by @kmendell)
use git cliff for releases (thanks pocket-id :))(d742817 by @kmendell)
refine settings pages (#532 by @cabaucom376)
update cliff.toml to include deps(9101ca3 by @kmendell)

Full Changelog: https://github.com/ofkm/arcane/compare/v1.1.0...v1.2.0

v1.1.0 - 2025-09-14

Release

Features

add usage badge to network table (6019045)
allow underscores in project names (2b464db)
container port links and overview (#457) (154107d)
move quick actions to the header for more simplified look (f0b43b6)
persistent table filters, page size, and column headers (#449) (a7a899a)

Bug Fixes

add /api/health endpoint to agent mode (83f0bc0)
allow use of the local templates directory (#462) (cae0df4)
check for updates only checking the current page of images (0da46a0)
do not recursive chown the /app/data/projects directory in entrypoint (368612a)
do not stop arcanes container it self when using the quick action (0166084)
dont allow the auto updater to update arcane it self (4b0931e)
make auto-update off by default on fresh installs (129c5c5)
project save button not using the correct styles (9825c4a)
projects are not searchable (31ce3e9)
reschedule jobs when polling or autoupdate job settings is changed (5c3f168)
update banner link not clickable (69e95e0)
use correct running container count on dashboard (3dad327)
use correct time for auto update job (e7a5a31)

v1.0.2 - 2025-09-12

Release

Bug Fixes

dashboard meters not using consistent styling in light/dark mode (21a93f5)
image pruning not respecting selected prune mode (e8b9207)
remove extra image id cell in image table (d288295)
show correct counts for stat cards (#437) (eb2ed73)
streamline image reference handling by stripping digests and ensuring tags (c2a3b7d)
update layout of sidebar and fix the missing label for language selector (2150088)
update learn more link for templates page (60e3d9b)
volume usage displays incorrectly (eb92b4f)
volume usage filters not filtering volumes (2d8437d)

v1.0.1 - 2025-09-10

Release

Bug Fixes

allow both http and https cookie names (b3b9f71)
onboarding flow not using correct values (c75839c)
onboarding not showing on fresh installs (51fa03a)
register project handler to fix projects not pulling (038ebf6)
use non secure cookie if running on http (fb2e6d9)

v1.0.0 - 2025-09-09

Release

⚠ BREAKING CHANGES

remote environments (#305)
migrate to Go backend, serve frontend from backend (#291)

Features

add copier utility functions for struct mapping (477c2d5)
add event details dialog (d14609c)
change port to 3552, cleanup old code (9705277)
enhance volume details with container names and IDs (1c5cb35)
events are now shown in the ui (#355) (49f51c4)
migrate logging to json (6ea6c77)
migrate logging to json (b66afe2)
migrate to Go backend, serve frontend from backend (#291) (b46454a)
redesign login page (8063f08)
remote environments (#305) (8fb5815)
show error status for image updates, show if a credential was used (7718605)
zod v4 form validation, and sheet based forms (#301) (77c6d96)

Bug Fixes

add container force removal checkboxes (6e449b2)
add exclude label for updater (123f575)
add loading indicators to metric cards, fix some styling on the dashboard (d9be7cc)
add missing isAdmin prop (659933a)
add missing props to button (044396c)
add more options for onboarding (#321) (45ae580)
add user ID validation in token verification process (5595894)
add validation for stack ID and improve error handling in GetStackLogsStream method (57f25d2)
auth redirect (i hope) (92c1685)
auth session redirect (9da620a)
auto update service logic (#323) (80f4ec8)
cleanup docker settings page ui (4874a48)
cleanup hooks and layout logic and disable SSR so local development works (e3750e5)
cleanup of orphaned image update records after applying updates (31155c5)
container details page not loading (c5e5b51)
correct counts of containers and images on dashboard (520a18a)
correctly use minute value for sessions timeout (3b3c9f4)
do not allow auth method to be turned off is only one is enabled (b310334)
do not run auto update job on container start (97736be)
enhance container stats and configuration display with derived flags for environment variables, ports, labels, and network settings (3a232df)
enhance login response to include token pair and set cookie for password change (587a656)
fix performance of projects page and rely only on filesystem watcher for updating the database (dee13bc)
global prune not pruning volumes (6a55fa1)
image dropdown not deleting images (12a2e8d)
image maturity/update logic (92ed4a0)
image table disappears when filtering images (12c6d9c)
improve error handling and streaming logic in GetStatsStream and GetLogsStream methods (3a407d3)
incorrect user response structure and missing types (4622ca6)
layout shift when using dropdown menus (e404eee)
lazy load all resources (066eadc)
make image update item reactive with status once clicked (fe5caf6)
make onboardin security settings page the same as the normal settings page (20800ef)
make sure oidc uses refresh tokens (9f185eb)
make System username red on event table (0a8bff6)
mismtached json type for database (44dbd27)
move auto updater to just updater confirm working with projects (1382213)
onboarding oidc config (cadda0a)
only allow role changes for oidc users (f5a3302)
only show edit user button for local users (a0eb2f4)
only show floating header after scrolling on compose page (6582e1e)
optimize conversion of slog attributes for logging (10df97f)
pagination round one fixes (containers, images, and projects) (8349d1b)
persist Docker image ID as primary key and improve tag selection logic (6e7ac85)
project files not removed when deleting from the ui (65c93c6)
projects page wont load if no stacks are found (320edc9)
redirect to /compose after project delete (ca8b4c6)
refactor user creation logic to use CreateUser type and improve type safety (6ccb106)
remove container registry field data on sheet reopen (66f26f5)
remove missing util file (23d7745)
remove oidc client secret from api responses (4ab9a9d)
remove ping group and utility in Dockerfile-static (c7ff050)
remove selected labels (6e3fd3e)
remove unused prop (3d8a350)
restore translucency to badges (1a93bdc)
return correct event api response on page load (f9f3082)
return correct network response data on page load (b767fd5)
revert redirect in layout (c659707)
rework templates with new schema (#389) (e40e06e)
session validation timeouts (a267b91)
settings not saving on submission (520178b)
show create container sheet (aa089c5)
show x of x running for container metric card (a03f336)
sidebar shows on logon (6f14c05)
simplify sqlite string, and make sure postgres migrations work (1a01113)
stack logic (#313) (b53caa2)
status badge color is now reactive (8c2c24d)
stopAll button use the correct count (8bd2f5c)
switch from bcrypt to argon2 for password hashing (1485a53)
template loading and usage (c994404)
truncate volume name text (5111195)
update link to template settings in dialog component (55b8fb5)
update system meters dynamically (16e41cf)
use Arcane as page title for all pages (c1f4aed)
use containerId for removing containers (20cf8c9)
use correct container data in api on page load (d33dedc)
use correct cookie timeout value (8b247a5)
use correct destructive variant for user dropdown menu (84fb150)
use correct image api response data (a08882a)
use correct redirect after login (58a4340)
use correct volume data in api on page load (c9bbffe)
use dedicated endpoint for totalImageSize (58edb08)
use dockerInfo for container and image counts (3413dc4)
use new image detail type (63f8211)
use preferred username in oidc cliams (ee46e9a)
use prune mode behavior (751f7c7)
user display not showing in sidebar (e059cf2)

v0.15.1 - 2025-06-12

Release

[!IMPORTANT]
This will be one of the last updates till a major rework, and most likely 1.0. You can track the progress on the 1.0.0 PR and branch!

Bug Fixes

compose network race condition (#274) (2a4401b)
layout of editors in compose details view (c052902)
proper compose validation (#272) (6f1eb03)
remove oidc env and args from docker build (e462e8b)

v0.15.0 - 2025-06-04

Release

Features

remote agents (#239) (82cbab5)
system usage meters (64dde28)
use drizzle as a database backend (#248) (54061d3)

Bug Fixes

agents not showing compose projects in table (0ab2757)
container creation type mismatches not allowing containers to be created (e8aece6)
container status sorting incorrect (#242) (64faad3)
cpu and ram usage bars not showing correct values (01fbb16)
create database in docker build (24b33e8)
deploy to agent dropdown button (#244) (6092c4f)
implement main compose spec functionality (#259) (e2fc0ac)
incorrect github link on login page (3205312)
missing ) in migrations (635d932)
parse ipam config correctly (2585d69)
pruning button not showing loading status (419cd9e)
remove duplicate agent sidebar item (6545794)
rename stacks to compose projects (#243) (b38b298)
rework auto update service (d88178a)
store image maturity in database instead of cache (#263) (1b29808)
support removing agents (c33a872)
use new template root url (55fdacd)
use system storage on dashboard (6e7a83c)
volumes table truncate not being applied (ce50de7)

v0.14.0 - 2025-05-29

Release

[!NOTE]
This update introduced Templates for compose stacks. You can use the community repo for templates (contributions welcome! at ofkm/arcane-templates) or can create your own. See the documentation for more details: https://arcane.ofkm.dev/docs/templates/create-a-registry

Features

compose and .env template (#231) (c47d15f)

v0.13.1 - 2025-05-28

Release

Features

allow changing user usernames (74321b5)
make compose editor widths resizeable (64c33e6)
simplify container and stack detail pages (#227) (65dfa64)

Bug Fixes

container log performance issues (#222) (d337474)
make font size more consistent in editors (efbbe75)
remove old references to app-settings.json (65f20d1)
theming not applying correct values (e0d125e)
update size classes for consistency across components (3ceb93d)

v0.13.0 - 2025-05-28

Release

Features

allow changing user usernames (74321b5)
make compose editor widths resizeable (64c33e6)
simplify container and satck detail pages (#227) (65dfa64)

Bug Fixes

container log performance issues (#222) (d337474)
make font size more consistent in editors (efbbe75)
remove old references to app-settings.json (65f20d1)
theming not applying correct values (e0d125e)
update size classes for consistency across components (3ceb93d)

v0.12.0 - 2025-05-25

Release

Features

convert docker run to docker compose (#219) (3da1db7)
stack logs tab (696d74a)

Bug Fixes

external networks names not being respected (712fa00)

v0.11.1 - 2025-05-24

Release

Bug Fixes

largest images differ on dashboard and container images pages (9ffd0f6)

v0.11.0 - 2025-05-23

Release

Features

save page sizes for all tables (e01d7eb)

Bug Fixes

cleanup failed stack deployments if they fail (6fa7bd7)
dashboard overview card arrangement (#215) (da87f3b)
stack deployments for external networks (#199) (dfdf1e0)
use correct stack api endpoints (4ea2c12)

v0.10.0 - 2025-05-17

Release

Features

environment variable support in compose files (#195) (4612271)

Bug Fixes

improve loading speed of stack and container pages (#194) (ccbbdb4)
stacks not starting with more than one network (#191) (77a32ee)
table selection states not getting invailidated (d1ef3cb)

v0.9.2 - 2025-05-15

Release

Bug Fixes

cache image maturity results to improve page loading (ee6eb1e)

v0.9.1 - 2025-05-15

Release

Bug Fixes

settings not loading values from json file (ad65e80)
volumes cant be deleted from volume details page (76bc5b8)

v0.9.0 - 2025-05-14

Release

Features

add dark / light mode toggle (f24cae1)
add logged in users name in sidebar (e86659b)
image maturity indicator and image update indicators (#181) (2eff068)
oidc login support (#172) (43609a8)

Bug Fixes

container logs duplicated and not formatted correctly (5aa5f04)
duplicated service badge links on stack start (aca8932)
selectedIds persisting after api call is returned (0c01485)
sort images and containers but uptime and size (05cc599)
stacks not deploying if a health check is defined (664f330)
truncate long images names on dashboard table (87556c9)
UI consistency and layout updates (#185) (1b85225)
use svg icon over png (da5a591)

v0.8.0 - 2025-05-12

Release

Features

private docker registries (#162) (cfeffd2)
remove delete button from actions dropdown menu for bulk removing (#169) (cc15fae)
used/unused filtering for images and volumes (#170) (451abf8)

Bug Fixes

dockerhost from settings not being respected (#171) (258c3f8)
importing stacks if files are in the data/stacks directory (#161) (9bfb479)
remove id columns from dashboard tables (a414cbb)
use uid/gid 2000 in container (#156) (bae85ae)

v0.7.1 - 2025-05-10

Release

Bug Fixes

compose stacks not starting from the stack directory (7090c4e)
container permissions and removed the need for DOCKER_GID (dde20c0)
show error messages in toasts (#148) (c5d6b90)

v0.7.0 - 2025-05-09

Release

Features

container service link for stacks (#131) (420cf91)
use stack names as folder names (#143) (537ea9f)

Bug Fixes

container logs not streaming from server (#138) (e5d9903)
container stats not live updating (#139) (d4f773c)
onboarding errors and protections (#142) (bceb0ec)
redirect to list view after removing a container or stack (0fa0f03)
remove stack name link when its external (7499aee)
use data in relative path for base directory (7f8dd2c)

v0.6.0 - 2025-05-06

Release

Features

.env configuration support (#128) (20e12df)

Bug Fixes

password policy not able to be saved (976cd83)
remove ping group and iputils from container so GID 999 is available (4a9e619)
user creation button not showing loading state (d79b2ff)

v0.5.0 - 2025-05-06

Release

[!IMPORTANT]
This updated includes two new ENV variables. One of which is required for Arcane to start:
REQUIRED: PUBLIC_SESSION_SECRET=your-secure-random-32-character-string-here # Generate using: openssl rand -base64 32
OPTIONAL: PUBLIC_ALLOW_INSECURE_COOKIES=true # Only should be used for local HTTP testing without SSL/TLS

Features

add confirmation dialog before stopping all running containers (1a696c0)

Bug Fixes

loading states on action buttons not reflecting status (8305078)
session cookie not being created on http sites (#112) (0ef6073)
use correct cursor on all buttons (50d4211)

v0.4.1 - 2025-05-05

Release

Bug Fixes

adjust ownership handling in entrypoint script (a3ec54a)

v0.4.0 - 2025-05-05

Release

Features

auto update containers and stacks (#83) (0a5132f)
dashboard quick actions (#77) (f82380b)
image inspection page (c3f5665)
network inspection page (#76) (89451f9)
user authentication (#86) (0ab0df3)
volume inspection page (#75) (1e6da7d)

Bug Fixes

container table showing when no containers found (4f63742)
disable autofill for input fields (c7ff1c0)
make sure data is watched by effect (cd89d48)
set default restart policy to unless-stopped (4c578e4)
show ipvaln/macvlan ip address on details page (77495da)
use for watching containers (e99ec10)

v0.3.0 - 2025-04-27

Release

Features

add container resource card (37ec736)
add create container logic (#53) (23b6e86)
add in-use/unused badge on volumes and images (75ea68b)
mass-delete images, volumes, and networks (#69) (b56303e)
settings page overhaul (#48) (f5ac649)

Bug Fixes

add api endpoints for stacks and container actions (#73) (6844e35)
add link to container details in table column (72bd842)
custom badge colors and look (a1e59bd)
disable checkbox if stack is external (93884eb)
image pulling not respecting user defined tag (41af290)
remove badges on detail pages (1da4c79)
remove badges on detail pages (4404bd2)
remove docker connected label from sidebar (13d9060)
restore yaml editor functionality (f0484ec)
show docker engine version in card (8e5fc5b)
show total image size in dashboard card (9e4749c)
stacks not saving on edit (ba13d7b)
unused badge color and layout (67e5bc5)
use new status badge instead of custom-badge (90303a6)

v0.2.0 - 2025-04-23

Release

Features

add yaml editor component (#44) (165404a)
implement full docker compose spec (#45) (103707f)
link stack containers to container details page (#41) (2939909)

v0.1.1 - 2025-04-22

Release

Bug Fixes

container details card layout (94fde0e)
container env details layout (b2f7e28)
container port details layout (721cacb)
log display improvements (8343c9d)
make container details grid more responsive (17b5abf)

Docker & Self-Hosted Deployment Verified OCI

1. Project Overview & Quickstart (getarcaneapp/arcane) Copy Chapter

File: README.md Copy Chapter

File: cli/README.md Copy Chapter

Install Copy Chapter

Versions Copy Chapter

Configure Copy Chapter

Authenticate (choose one) Copy Section

Option A: Device code (OIDC must be enabled for this method, as it uses your external provider.)

Option B: API key

Useful Global Flags Copy Chapter

Utilities Copy Chapter

Pagination Config Copy Chapter

2. Official Technical Reference & Guides (getarcaneapp/website) Copy Chapter

File: README.md Copy Chapter

Arcane Documentation Website

Developing Copy Chapter

PR Previews Copy Chapter

File: content/changelog/2025.md Copy Chapter

title: 'Changelog 2025' Copy Chapter

v1.11.2 - 2025-12-28 Copy Chapter

Backend - Bug fixes Copy Section

v1.11.1 - 2025-12-27 Copy Chapter

Backend - Bug fixes Copy Section

CLI - Bug fixes Copy Section

Dependencies Copy Section

v1.11.0 - 2025-12-24 Copy Chapter

Backend - New features Copy Section

CLI - New features Copy Section

Backend - Bug fixes Copy Section

CLI - Bug fixes Copy Section

Backend - Performance improvements Copy Section

Dependencies Copy Section

Other Copy Section

v1.10.1 - 2025-12-03 Copy Chapter

Bug fixes Copy Section

Dependencies Copy Section

Other Copy Section

v1.10.0 - 2025-11-30 Copy Chapter

New features Copy Section

Bug fixes Copy Section

Performance Improvements Copy Section

Dependencies Copy Section

Other Copy Section

v1.9.0 - 2025-11-16 Copy Chapter

New features Copy Section

Bug fixes Copy Section

Dependencies Copy Section

Other Copy Section

v1.8.1 - 2025-11-10 Copy Chapter

Bug fixes Copy Section

Dependencies Copy Section

v1.8.0 - 2025-11-07 Copy Chapter

New features Copy Section

Bug fixes Copy Section

Dependencies Copy Section

Other Copy Section

v1.7.2 - 2025-10-30 Copy Chapter

Bug fixes Copy Section

v1.7.1 - 2025-10-30 Copy Chapter

Bug fixes Copy Section

Other Copy Section

v1.7.0 - 2025-10-29 Copy Chapter

New features Copy Section

Bug fixes Copy Section

Other Copy Section

v1.6.0 - 2025-10-19 Copy Chapter

New features Copy Section

Bug fixes Copy Section

Other Copy Section

v1.5.2 - 2025-10-13 Copy Chapter

Bug fixes Copy Section

Performance Improvements Copy Section

Other Copy Section

v1.5.1 - 2025-10-12 Copy Chapter

Bug fixes Copy Section

Other Copy Section

v1.5.0 - 2025-10-11 Copy Chapter

New features Copy Section

Bug fixes Copy Section

1. Project Overview & Quickstart (getarcaneapp/arcane)

File: README.md

File: cli/README.md

Install

Versions

Configure

Authenticate (choose one)

Useful Global Flags

Utilities

Pagination Config

2. Official Technical Reference & Guides (getarcaneapp/website)

File: README.md

Developing

PR Previews

File: content/changelog/2025.md

title: 'Changelog 2025'

v1.11.2 - 2025-12-28

Backend - Bug fixes

v1.11.1 - 2025-12-27

Backend - Bug fixes

CLI - Bug fixes

Dependencies

v1.11.0 - 2025-12-24

Backend - New features

CLI - New features

Backend - Bug fixes

CLI - Bug fixes

Backend - Performance improvements

Dependencies

Other

v1.10.1 - 2025-12-03

Bug fixes

Dependencies

Other

v1.10.0 - 2025-11-30

New features

Bug fixes

Performance Improvements

Dependencies

Other

v1.9.0 - 2025-11-16

New features

Bug fixes

Dependencies

Other

v1.8.1 - 2025-11-10

Bug fixes

Dependencies

v1.8.0 - 2025-11-07

New features

Bug fixes

Dependencies

Other

v1.7.2 - 2025-10-30

Bug fixes

v1.7.1 - 2025-10-30

Bug fixes

Other

v1.7.0 - 2025-10-29

New features

Bug fixes

Other

v1.6.0 - 2025-10-19

New features

Bug fixes

Other

v1.5.2 - 2025-10-13

Bug fixes

Performance Improvements

Other

v1.5.1 - 2025-10-12

Bug fixes

Other

v1.5.0 - 2025-10-11

New features

Bug fixes

Other

v1.4.0 - 2025-10-05

New features

Bug fixes