websoft9dev/umbraco repository overview

⁠Umbraco on Docker

⁠Quick Start

⁠Deploy Verification

1. In the Websoft9⁠ console, open My Apps and select Umbraco.
2. In the Access tab, get the login URL and credentials.
3. Open the login URL in a browser and sign in to confirm the app works.

⁠Usage

1. Open https://<host>:${W9_HTTPS_PORT_SET} from the Access tab and accept the self-signed certificate warning.
2. Sign in to the backoffice at /umbraco with the credentials from the Access tab.
3. Create your first content node to confirm the publishing flow.

⁠Change Password

1. Change the administrator password from the user profile inside the Umbraco backoffice.
2. W9_LOGIN_USER and W9_LOGIN_PASSWORD create the administrator on first start only; changing them afterwards requires updating the user in the backoffice or removing the umbraco_data volume and rebuilding.

⁠Configuration Reference

Websoft9 packages this app from the official Umbraco Docker image⁠ and makes some improvements below.

• Umbraco runs HTTPS by default with a self-signed certificate generated on first start and stored in the umbraco_data volume.
• Application logs are written to both docker logs and the persisted Umbraco log files under /app/umbraco/Logs.

docker compose up uses the prebuilt image ${W9_REPO}:${W9_VERSION}. The local Dockerfile is kept for separate image build/publish workflows and is not invoked by the runtime compose file.

Apps run as containers; recreate after any configuration change.

⁠Version Support

Supported versions: 18.2.0.

⁠Ports

⁠Data Directory

• umbraco_data → /app/umbraco
• umbraco_media → /app/wwwroot/media

⁠Environment Variables

Environment variables are defined in the app's .env file; see the reference section at the end of .env for supported variables.

Note: W9_LOGIN_USER, W9_LOGIN_PASSWORD take effect on first startup only; changing them after deployment may not take effect until the app is re-initialized.

⁠Configuration Files

Configuration files live inside the image; mount a single file read-only to override, and never replace the whole directory.

⁠References

• Umbraco Administrator Guide⁠ by Websoft9

• Docker Hub image⁠

• Releases⁠

• Official docs⁠

• Official docs⁠

⁠Troubleshooting

App fails to start?

• Check docker compose logs.

Certificate warning in the browser?

• The package serves a self-signed certificate by default. Open https://<host>:${W9_HTTPS_PORT_SET} and accept the warning, or replace it with your own certificate at the reverse proxy layer.

Port not reachable?

• Ensure the firewall / security group allows the HTTPS port.