Skip to content

feat(infra): add Dokploy template docs and variable mapping - #247

Open
juandelperal wants to merge 1 commit into
peaberry-studio:mainfrom
juandelperal:feat/dokploy-template
Open

feat(infra): add Dokploy template docs and variable mapping#247
juandelperal wants to merge 1 commit into
peaberry-studio:mainfrom
juandelperal:feat/dokploy-template

Conversation

@juandelperal

Copy link
Copy Markdown

Summary

  • add Dokploy onboarding docs for Arche template usage
  • define Dokploy variable mapping for domain, secrets, admin bootstrap, and runtime paths
  • document validation, rollback, and publish flow for Dokploy blueprints

Test plan

  • Validate template import in Dokploy
  • Confirm web health endpoint returns 200 at /api/health
  • Confirm admin login with seeded credentials
  • Confirm workspace creation and startup

Add Dokploy onboarding documentation and template variable wiring so Arche can be imported and configured consistently in Dokploy projects.

Made-with: Cursor
@juandelperal

Copy link
Copy Markdown
Author

I had trouble running this on an arm dokploy instance. The images are x86

@juandelperal
juandelperal marked this pull request as ready for review April 10, 2026 13:53
@juandelperal juandelperal mentioned this pull request Apr 10, 2026

@albertoperdomo2 albertoperdomo2 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for putting this together, Juan! Great to have the Dokploy blueprint scaffolding in place.

A few things I noticed:

Missing files referenced in the README
The README lists arche/docker-compose.yml and arche/instructions.md as included, but they're not in the PR. Without at least the compose file the template can't be imported into Dokploy. Could you either add them here or scope the README to what's currently present?

KB_HOST_PATH undocumented
template.toml defines KB_HOST_PATH = "" and passes it through, but the README doesn't mention it. Should it be removed or documented?

[[config.domains]] uses ${domain} vs ${ARCHE_DOMAIN}
Just want to confirm ${domain} is the correct Dokploy built-in here and not a typo for ${ARCHE_DOMAIN}.

@juandelperal

Copy link
Copy Markdown
Author

Hey Arche team, thanks for the feedback. I can work on your suggestions.

Would it be possible to publish an arm64 image as well? Getting this error on an ARM EC2 running Dokploy — building locally works as a workaround but it's not ideal.

image

@albertoperdomo2

Copy link
Copy Markdown
Contributor

Hi @juandelperal - The arch issue is being addressed in #270 so soon there should be arm64 image too, for both the workspace and the web app.

@juandelperal

Copy link
Copy Markdown
Author

Hi Alberto and team!

In arm this keeps happening:

image

is this the right tag or should i set something different here?
WEB_IMAGE = "ghcr.io/peaberry-studio/arche/web:latest"

Thanks

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants