mirror of
https://github.com/frappe/frappe_docker.git
synced 2026-06-17 13:55:08 +00:00
09934d576c
* docs: reorganize documentation structure into logical categories Restructure documentation into organized directories for better navigation: - getting-started/: Quick start guides for new users - setup/: Setup and configuration guides - production/: Production deployment guides (backup, TLS, multi-tenancy) - operations/: Site operations and management - development/: Development workflow guides - migration/: Migration guides - troubleshooting/: Troubleshooting guides - reference/: Reference documentation (container setup, build configs) Rename files for consistency: - Use kebab-case naming convention throughout - Remove numbered prefixes from container-setup files - Use descriptive names (backup-strategy, tls-ssl-setup, etc.) Update all internal cross-references to reflect new file locations. Update README.md with organized documentation structure. Fix image paths in development.md to use correct relative paths. * docs: add numeric prefixes to directories and files for navigation order Add numeric prefixes (01-08) to documentation directories to indicate reading order and flow for first-time users: - 01-getting-started: Quick start guides - 02-setup: Setup and configuration - 03-production: Production deployment - 04-operations: Site operations - 05-development: Development guides - 06-migration: Migration guides - 07-troubleshooting: Troubleshooting - 08-reference: Reference documentation Add numeric prefixes to files within directories to guide readers through documentation in a logical sequence. Update all cross-references throughout documentation to use new numbered paths. Update README.md to reflect the new structure. * docs: move container-setup to 02-setup and integrate setup-options content Move container-setup directory from 08-reference/ to 02-setup/ to follow PR feedback. The container-setup documentation provides a more linear and coherent flow compared to the previous unstructured setup files. Changes: - Move container-setup/ from docs/08-reference/ to docs/02-setup/ - Integrate content from setup-options.md into structured flow: - Create new 06-setup-examples.md with practical deployment scenarios - Enhance 03-start-setup.md with site creation details from setup-options - Remove redundant 01-setup-options.md (content now integrated) - Rename 02-single-server-example.md to 07-single-server-example.md - Update all cross-references throughout documentation: - Update README.md with new structure under Setup section - Fix links in site-operations.md and migration docs - Add navigation links between container-setup files and examples - Maintain container-setup's linear flow: overview → build → start → env → overrides - Add practical examples document (06-setup-examples.md) that follows the container-setup guide Result: Documentation now follows a clear progression from conceptual overview through practical examples, with all setup information properly organized under 02-setup/. * docs: remove container-setup subfolder and flatten structure Move all files from docs/02-setup/container-setup/ directly into docs/02-setup/ to eliminate unnecessary subfolder. Files are already numbered sequentially, so they work perfectly at the same level. Changes: - Move all files from container-setup/ subfolder to 02-setup/ root - Remove container-setup/ subfolder - Update all cross-references: - Update README.md paths (remove container-setup/ from all links) - Fix references in site-operations.md - Fix references in migration docs - Update internal references in 06-setup-examples.md - Fix relative path references in 01-overview.md, 02-build-setup.md, 03-start-setup.md Result: Cleaner, flatter structure with all numbered setup files at the same level, making navigation more straightforward. * fix: Pre-commit failure is fixed --------- Co-authored-by: adithya <adithya.a@bayesian.in>
110 lines
4.6 KiB
Markdown
110 lines
4.6 KiB
Markdown
[](https://github.com/frappe/frappe_docker/actions/workflows/build_stable.yml)
|
|
[](https://github.com/frappe/frappe_docker/actions/workflows/build_develop.yml)
|
|
|
|
Everything about [Frappe](https://github.com/frappe/frappe) and [ERPNext](https://github.com/frappe/erpnext) in containers.
|
|
|
|
# Getting Started
|
|
|
|
**New to Frappe Docker?** Read the [Getting Started Guide](docs/getting-started.md) for a comprehensive overview of repository structure, development workflow, custom apps, Docker concepts, and quick start examples.
|
|
|
|
To get started you need [Docker](https://docs.docker.com/get-docker/), [docker-compose](https://docs.docker.com/compose/), and [git](https://docs.github.com/en/get-started/getting-started-with-git/set-up-git) setup on your machine. For Docker basics and best practices refer to Docker's [documentation](http://docs.docker.com).
|
|
|
|
Once completed, chose one of the following two sections for next steps.
|
|
|
|
### Try in Play With Docker
|
|
|
|
To play in an already set up sandbox, in your browser, click the button below:
|
|
|
|
<a href="https://labs.play-with-docker.com/?stack=https://raw.githubusercontent.com/frappe/frappe_docker/main/pwd.yml">
|
|
<img src="https://raw.githubusercontent.com/play-with-docker/stacks/master/assets/images/button.png" alt="Try in PWD"/>
|
|
</a>
|
|
|
|
### Try on your Dev environment
|
|
|
|
First clone the repo:
|
|
|
|
```sh
|
|
git clone https://github.com/frappe/frappe_docker
|
|
cd frappe_docker
|
|
```
|
|
|
|
Then run: `docker compose -f pwd.yml up -d`
|
|
|
|
### To run on ARM64 architecture follow this instructions
|
|
|
|
After you clone the repo and `cd frappe_docker`, run this command to build multi-architecture images specifically for ARM64.
|
|
|
|
`docker buildx bake --no-cache --set "*.platform=linux/arm64"`
|
|
|
|
and then
|
|
|
|
- add `platform: linux/arm64` to all services in the `pwd.yml`
|
|
- replace the current specified versions of erpnext image on `pwd.yml` with `:latest`
|
|
|
|
Then run: `docker compose -f pwd.yml up -d`
|
|
|
|
## Final steps
|
|
|
|
Wait for 5 minutes for ERPNext site to be created or check `create-site` container logs before opening browser on port 8080. (username: `Administrator`, password: `admin`)
|
|
|
|
If you ran in a Dev Docker environment, to view container logs: `docker compose -f pwd.yml logs -f create-site`. Don't worry about some of the initial error messages, some services take a while to become ready, and then they go away.
|
|
|
|
# Documentation
|
|
|
|
### [Getting Started Guide](docs/getting-started.md)
|
|
|
|
### [Frequently Asked Questions](https://github.com/frappe/frappe_docker/wiki/Frequently-Asked-Questions)
|
|
|
|
### [Getting Started](#getting-started)
|
|
|
|
- [Quick Start (Linux/Mac)](docs/01-getting-started/01-quick-start-linux-mac.md)
|
|
- [Single Compose Setup](docs/01-getting-started/02-single-compose-setup.md)
|
|
|
|
### [Setup](#setup)
|
|
|
|
- [Container Setup Overview](docs/02-setup/01-overview.md)
|
|
- [Build Setup](docs/02-setup/02-build-setup.md)
|
|
- [Start Setup](docs/02-setup/03-start-setup.md)
|
|
- [Environment Variables](docs/02-setup/04-env-variables.md)
|
|
- [Compose Overrides](docs/02-setup/05-overrides.md)
|
|
- [Setup Examples](docs/02-setup/06-setup-examples.md)
|
|
- [Single Server Example](docs/02-setup/07-single-server-example.md)
|
|
|
|
### [Production](#production)
|
|
|
|
- [TLS/SSL Setup](docs/03-production/01-tls-ssl-setup.md)
|
|
- [Backup Strategy](docs/03-production/02-backup-strategy.md)
|
|
- [Multi-Tenancy](docs/03-production/03-multi-tenancy.md)
|
|
|
|
### [Operations](#operations)
|
|
|
|
- [Site Operations](docs/04-operations/01-site-operations.md)
|
|
|
|
### [Development](#development)
|
|
|
|
- [Development Guide](docs/05-development/01-development.md)
|
|
- [Debugging](docs/05-development/02-debugging.md)
|
|
- [Local Services Connection](docs/05-development/03-local-services-connection.md)
|
|
|
|
### [Migration](#migration)
|
|
|
|
- [Migrate from Multi-Image Setup](docs/06-migration/01-migrate-from-multi-image-setup.md)
|
|
|
|
### [Troubleshooting](#troubleshooting)
|
|
|
|
- [Troubleshoot Guide](docs/07-troubleshooting/01-troubleshoot.md)
|
|
- [Windows Nginx Entrypoint Error](docs/07-troubleshooting/02-windows-nginx-entrypoint-error.md)
|
|
|
|
### [Reference](#reference)
|
|
|
|
- [Build Version 10 Images](docs/08-reference/01-build-version-10-images.md)
|
|
|
|
# Contributing
|
|
|
|
If you want to contribute to this repo refer to [CONTRIBUTING.md](CONTRIBUTING.md)
|
|
|
|
This repository is only for container related stuff. You also might want to contribute to:
|
|
|
|
- [Frappe framework](https://github.com/frappe/frappe#contributing),
|
|
- [ERPNext](https://github.com/frappe/erpnext#contributing),
|
|
- [Frappe Bench](https://github.com/frappe/bench).
|