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 the Umbraco site from the Access tab.
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.

• This package disables OpenIddict's HTTPS transport requirement for backoffice authentication so the admin UI can be reached over plain HTTP when needed. Prefer HTTPS on untrusted networks.

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-hotfix.1.

⁠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.

Port not reachable?

• Ensure the firewall / security group allows the port.