Is craftplan still maintained?

Yes, active. Last change 11 days ago. Latest release v0.7.7, 15 days ago.

Can I trust craftplan?

Widely used. 1.2k stars, 1 years old. As with any download, get it from the official repo.

gitmanual

Reading the repo

Opening the box…

How to install craftplan on macOS (puemos/craftplan) · gitmanual

How to install on macOS

puemos/craftplan

Self-hosted software for managing artisanal D2C micro-businesses

ElixirPhoenix#artisanal#d2c#erp#self-hosted

Before you start

Is it free?: YesOpen source (AGPL-3.0).
Still maintained?: Yes, activeLast change 11 days ago. Latest release v0.7.7, 15 days ago.
Can I trust it?: Widely used1.2k stars, 1 years old. As with any download, get it from the official repo.

Difficulty: Moderate
Time: 30 min or more
Stars: ★ 1,156
Activity: Updated this month

Saved setup from 4 h ago

Will it work on macOS?

Yes, with Docker on macOS

It's a self-hosted app: the README runs it with Docker, and you open it in your browser.
On macOS that means installing Docker Desktop first.

Your system

macOS Windows Linux

Start here

Website ↗puemos.github.ioThe project's own site.

Heads-upBuilding it yourself? It also needs PostgreSQL and 6 settings in .env (4 secret).

Run it with Docker

A self-hosted app: Docker runs it on your computer and you open it in the browser. Needs Docker Desktop (or Docker Engine on Linux). Run docker compose commands inside the cloned repo folder.

Docker

docker compose up -d

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

GitManual AI Agent reads the 9 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Elixir ~> 1.20runtime
1×Docker tool
1×PostgreSQL service

6× settings in .env

SECRET_KEY_BASEsecret
TOKEN_SIGNING_SECRETsecret
CLOAK_KEYsecret
POSTGRES_PASSWORDsecret
HOST
PORT

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/puemos/craftplan/badge.svg)](https://gitmanual.com/puemos/craftplan)

Good to know

Dockerfile available (base image: ${BUILDER_IMAGE}).
Tool versions pinned in mise.toml — mise install (or asdf install) installs them all.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: assets/package.json, docs/package.json

Details

License: AGPL-3.0
Open issues: 5
Branch: main

Files we read (9)

.env.example

.github/workflows/ci.yml

.github/workflows/deploy-docs.yml

.github/workflows/docker-publish.yml

Dockerfile

README.md

docker-compose.yml

mise.toml

mix.exs

551 files in the repo

Yes, with Docker on macOS

Start here

Run it with Docker

Did you get it running?

Still stuck? Get a written guide

More like craftplan that run on macOS