TryGhost / TryGhost/ghost-docker

Workflow for Theme Development, Permissions Issues?

Open
#171 6 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Shell
Stars
95
Forks
96
Avg merge
1d 1h
Merged PRs (30d)
32

Description

Hi!

I understand that this is a newer deployment pipeline for Ghost, but I happened to be building a local development workflow and discovered that this is where things are headed.

When I spin up the docker compose stack it works.

Now I copied my theme into the volume where it belongs. Upon restarting ghost, it tries to chown all of the theme files and doesn't start. Next, I tried chowning all of the theme files from the shell in my host environment to 1000:1000 (which does seem to be correct for the ghost container's user). That did not work either.

The only thing that worked is chmoding the theme to 777 from the host shell. Ghost starts fine, and the theme is accessible from the admin panel. Certainly this isn't the only solution though, right? Ghost CLI will not run a theme with these permissions. I want to develop on the exact same folder and permissions as I would deploy in production.

Bottom line, if I have a json export of my blog and a folder with my theme, what is the recommended workflow for local development?

Thank you for this fun, self-hosted tool. I've been using Ghost for over 10 years.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the docker-compose stack and the host-mounted theme workflow described in the issue, focusing on container ownership and permissions. Reproduce the setup with a JSON export and theme folder, then document the recommended local-development workflow, including permissions that work without chmod 777 and remain compatible with Ghost CLI.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, docker-compose, shell
Domain
devops, documentation, infrastructure
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.