From nobody Fri Oct 3 10:41:14 2025 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4cdQF64l2Gz69S7R for ; Fri, 03 Oct 2025 10:41:14 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cdQF649T9z3Jfk; Fri, 03 Oct 2025 10:41:14 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1759488074; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=iI8dJoaGLXvt/2NGc3oXix4Q6Rz2hdk30J7xvYFBx0c=; b=V6jElaRl40ZOd2TUKMaheOENB5T4qztmcPIxunr+XqaHUqYZnUaupDusTLzWzJxLgjgzcN w1YFrNQDJPl2j8DMHzRcX0+4v2XM8Tt/lABGDP+B0+tsuBqze7BNGi0szpZD215fXeaog5 kWFvQg8PtUzKkFuHlCd7mcWjiY6J7NCQpgbqiqk6df6cma9tfODWphy/gpPWnMy4oRuwtG 9Dye29gSXCLij4GFfnKHUx5Zm5rLmI/lHUD+s9CsSI3l3ATU6jV+1yvEmX145lwlR38Pel Wh2iDbhrSgV9SC6OTm7nD/yxZmi0i9uRcO/KGx3UuLe5YYSQBDxmX9IM7RsKfA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1759488074; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=iI8dJoaGLXvt/2NGc3oXix4Q6Rz2hdk30J7xvYFBx0c=; b=xsBp1/nJPhZT6PBBBe0FJzqe262YQB/8R4yHg/oA8oxj5GIiXOrnNIgBnyLkzIpi41hXLN d0FYH5IzqUO0E6jPcpttABQ95JThy6SBv9wwKQ41CXKwnsReRg8dxiCZz2anHI+Z0fi5vy 30Is4aKfk8Vgr9O1C/gJtQwktOLoNr5Cjq1F6W/H72H7y9o066E5j+3VhoQ7q9+X/yI12w UF0XVcS4+Ajm6i65MTbKMJKYu75cbMFOqwScSVk197rklLoc+zPrxu/4cU2yEZE7W6wj/s NhT95Ao3NmmPQQdFv/ZFB06CrFPlAhnH0CGyxCN+H+GeNiLJ8564nlwGmtmhzw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1759488074; a=rsa-sha256; cv=none; b=KUPRw3m0dQaClpPH8f0AOMaJE5m4jm3R4fnHl20fVH/V3apA7ciCO1LQMbcWST5rar4idK mC9YXMW6IpGufH9uOeKFxByCqswKpSB2rbmPqdYb39nj5YuDRtlr5qYU1I9vB4eGtYO2y5 eZZRBn3bQUQQ0yFjHLaI8uzVkz8uUHPoDaPiVTZDxCbdWvc1KHlCf/GyTkF5XtiemmmnF/ DUMaO3yZ3xe+UoP4xszkh1oWj9cohC84rKqFC0Kn8+gAWvx3vOR4Gd3LJBPjUg3c8MNACG wiM+A1FnqqIb7D5b9P7xfgn68jh0SZYtirys+nN/P9CgEneFSNUZaxnXD0/oVQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4cdQF63DDdzrwV; Fri, 03 Oct 2025 10:41:14 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 593AfECD063455; Fri, 3 Oct 2025 10:41:14 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 593AfEfC063452; Fri, 3 Oct 2025 10:41:14 GMT (envelope-from git) Date: Fri, 3 Oct 2025 10:41:14 GMT Message-Id: <202510031041.593AfEfC063452@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: 24aaf6817b - main - Status/2025Q3/appjail.adoc: Add report List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 24aaf6817b9d1abd1e723e11f9c0fc8b5975c37e Auto-Submitted: auto-generated The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=24aaf6817b9d1abd1e723e11f9c0fc8b5975c37e commit 24aaf6817b9d1abd1e723e11f9c0fc8b5975c37e Author: Jesús Daniel Colmenares Oviedo AuthorDate: 2025-10-03 08:54:04 +0000 Commit: Lorenzo Salvadore CommitDate: 2025-10-03 09:28:03 +0000 Status/2025Q3/appjail.adoc: Add report Reviewed by: Chris Moerz --- .../en/status/report-2025-07-2025-09/appjail.adoc | 41 ++++++++++++++++++++++ 1 file changed, 41 insertions(+) diff --git a/website/content/en/status/report-2025-07-2025-09/appjail.adoc b/website/content/en/status/report-2025-07-2025-09/appjail.adoc new file mode 100644 index 0000000000..3a0193be69 --- /dev/null +++ b/website/content/en/status/report-2025-07-2025-09/appjail.adoc @@ -0,0 +1,41 @@ +=== Container orchestration: Overlord, Director, AppJail and cloud-init + +Links: + +link:https://github.com/DtxdF/AppJail[AppJail on Github] URL: link:https://github.com/DtxdF/AppJail[] + +link:https://github.com/DtxdF/Director[Director on Github] URL: link:https://github.com/DtxdF/Director[] + +link:https://github.com/DtxdF/Overlord[Overlord on Github] URL: link:https://github.com/DtxdF/Overlord[] + +link:https://github.com/AppJail-makejails[Makejails] URL: link:https://github.com/AppJail-makejails[] + +Contact: Jesús Daniel Colmenares Oviedo + +**AppJail** is an open-source BSD-3 licensed framework entirely written in POSIX shell and C to create isolated, portable and easy to deploy environments using FreeBSD jails that behaves like an application. + +**Director** is a tool for running multi-jail environments on link:https://github.com/DtxdF/AppJail[AppJail] using a simple YAML specification. +A Director file is used to define how one or more jails that make up your application are configured. +Once you have a Director file, you can create and start your application with a single command: `appjail-director up`. + +**Overlord** is a fast, distributed orchestrator for FreeBSD jails oriented to GitOps. +You define a file with the service intended to run on your cluster and deployment takes seconds to minutes. +This orchestration tool uses link:https://github.com/DtxdF/AppJail[AppJail], link:https://github.com/DtxdF/director[Director] and can even create VMs with link:https://github.com/FreeBSD/vm-bhyve[vm-bhyve], but as its philosophy is "deploy using code" you can create a single file once and deploy many times. +Through a tree chaining system Overlord deploys jails on connected systems sharing their resources almost infinitely. +See the link:https://github.com/DtxdF/Overlord/wiki[wiki] for articles that use Overlord. + +**Recently written articles about Overlord**: + +* link:https://freebsdfoundation.org/our-work/journal/browser-based-edition/networking-3/overlord-deploy-jails-as-fast-as-you-code/[Overlord: Deploy Jails as Fast as You Code] +* link:https://github.com/DtxdF/overlord/wiki/cloud-init[Deploying virtual machines using cloud-init] +* link:https://github.com/DtxdF/overlord/wiki/ephemeral[Deploying virtual machines with ephemeral jails] +* link:https://github.com/DtxdF/overlord/wiki/gitops[Using GitOps with Overlord] +* link:https://dtxdf.github.io/jellyseerr.html[How to install Jellyfin and Jellyseerr using Overlord] + +**Makejails** are simple text files that automate the steps to create a jail, a widely used feature of link:https://github.com/DtxdF/AppJail[AppJail]. +Currently, there are many Makejails created and hosted in the link:https://github.com/AppJail-makejails[Centralized Repository], but here are some of the recently written ones: + +* link:https://github.com/AppJail-makejails/odoo[Odoo] +* link:https://github.com/AppJail-makejails/writefreely[WriteFreely] +* link:https://github.com/AppJail-makejails/adminer[Adminer] +* link:https://github.com/AppJail-makejails/shiori[Shiori] +* link:https://github.com/AppJail-makejails/healthchecks[Healthchecks] +* link:https://github.com/AppJail-makejails/ntfy[ntfy] + +Sponsor: https://www.patreon.com/appjail