nano_press - GitLite

KO | EN

gitlite — search

#vue #markdown #nodejs #animation #ruby #list #nextjs #machine-learning #rag #agent

nano_press

(★ 78)

Nano Press automates your Frappe/ERPNext deployment from zero to production. Connect your server, pick your version, add official or custom GitHub apps, set your domain, and launch — all in one smooth workflow. Built for quick proof-of-concepts, but powerful enough for real-world use.

File Explorer

ZIP Download

- - ci.yml
  - linter.yml
  - linters.yml
- - __init__.py
- - custom_docperm.json
  - role.json
- - .frappe
  - __init__.py
- - .gitkeep
- - __init__.py
  - layout.html
- - ansible_runner.py
- - log.html
  - log.py
  - self-host.html
  - self_host.py
- __init__.py
- api.py
- hooks.py
- modules.txt
- patches.txt
.editorconfig
.eslintrc
.gitignore
.pre-commit-config.yaml
biome.json
commitlint.config.js
license.txt
package-lock.json
package.json
pyproject.toml
README.md
yarn.lock

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`eslint`

View Details ▼

A pluggable linting utility for JavaScript and JSX.

eslint --init

Create the ESLint configuration file:

eslint {{path/to/file1.js path/to/file2.js ...}}

Lint one or more files:

eslint --fix

Fix lint issues:

🔍

`pre-commit`

View Details ▼

Create Git hooks that run before commits.

pre-commit install

Install pre-commit into your Git hooks:

pre-commit run

Run pre-commit hooks on all staged files:

pre-commit run --all-files

Run pre-commit hooks on all files, staged or unstaged:

🔍

`prettier`

View Details ▼

An opinionated code formatter for JavaScript, JSON, CSS, YAML, and more.

prettier {{path/to/file}}

Format a file and print the result to `stdout`:

prettier --check {{path/to/file}}

Check if a specific file has been formatted:

prettier --config {{path/to/config_file}} {{path/to/file}}

Run with a specific configuration file:

🔍

`ruff`

View Details ▼

An extremely fast Python linter and code formatter, written in Rust.
See also: `black`.

tldr ruff check

View documentation for the Ruff linter:

tldr ruff format

View documentation for the Ruff code formatter:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Nano Press automates the full lifecycle of a self-hosted Frappe/ERPNext deployment—from connecting a fresh server to shipping production-ready sites. It wraps Ansible automation, server health checks, app management, and site provisioning into a guided workflow that lives inside your Frappe desk.

![Nano Press Dashboard](https://raw.githubusercontent.com/bwhtech/nano_press/develop/nano_press/public/images/dashboard.png)

## Why teams choose Nano Press

- Automates server preparation (Docker, Traefik, lets-encrypt) and ongoing health checks.
- Orchestrates benches, sites, and custom apps without leaving the Frappe UI.
- Logs every Ansible run for traceability and surfaces build/deploy notifications in-app and by email.
- Adds optional custom images so repeated deployments are significantly faster.
- Ships with onboarding guides and video walkthroughs so new operators can go live in minutes.

## Prerequisites

- Frappe/ERPNext bench where the `nano_press` app is installed and enabled.
- Target VM or bare-metal host (Ubuntu 20.04 LTS or newer recommended) with SSH access.
- User with `sudo` privileges on the target host.
- Domain name (optional but required for HTTPS; Nano Press can provision a free `traefik.me` subdomain if you do not have one).
- Open ports 22, 80, and 443 on the target network.

> Docker, Docker Compose, Traefik, and other runtime dependencies are installed for you during the server preparation step.

## Quick start

1. Install the app on your bench:
   ```bash
   cd $PATH_TO_YOUR_BENCH
   bench get-app https://github.com/<your-org>/nano_press.git --branch develop
   bench install-app nano_press
   ```
2. Log in to your desk as a system manager and open **Nano Press** from the workspace sidebar.
3. Follow the guided onboarding shown below to connect a server, add apps, and launch your site.

## Guided onboarding workflow

| Step | What happens | Related doctypes | Watch the walkthrough |
| --- | --- | --- | --- |
| 1. Create a Server | Register the host, SSH credentials, and Traefik settings. Nano Press keeps the connection info and prepares the machine with Docker and dependencies. | `Server` | [Create a Server](https://drive.google.com/file/d/1LtpQADJkGMXgfdmlQG12rEYQcgfm9y-_/view?usp=sharing) |
| 2. Verify Server Connection | Trigger an Ansible ping to confirm Nano Press can reach the host. | `Server` | [Verify Server Connection](https://drive.google.com/file/d/1LtpQADJkGMXgfdmlQG12rEYQcgfm9y-_/view?usp=sharing) |
| 3. Add Frappe Apps | Add official or custom GitHub apps you want baked into your bench. Supports private repos via deploy keys. | `Apps` | [Add Frappe Apps](https://drive.google.com/file/d/1mRkhB61ZIk0NVC8P_KfnnIG-q401Mr68/view?usp=sharing) |
| 4. Build Custom Image (optional) | Build a reusable Docker image that includes your chosen apps. Great for staging/prod parity or repeated rollouts. | `Custom Image` | [Build a Custom Image](https://drive.google.com/file/d/1X_N84--9Z6gFQuaJ0LZnReGEVRM7KsLW/view?usp=sharing) |
| 5. Deploy Server | Launch a Frappe site with your selected apps, configure domains/SSL, and receive email notifications when it is live. | `Frappe Site` | [Deploy Your Server](https://drive.google.com/file/d/1qyBLdLIorqgm_V61DoUIFWqH78ltN-_G/view?usp=sharing) |

### Accessing a freshly deployed site

- Default URL: `https://<site_url>` (swap for your domain if SSL is configured).
- Default credentials: `Administrator` and the password set during deployment.

## Operations checklist

- **Monitor builds**: Track progress from the **Build Log** doctype; Nano Press also raises desk notifications and optional emails when a build or deploy completes.
- **Review automation output**: Each Ansible run is stored under `Ansible Log` for audit and troubleshooting.
- **Rerun preparation**: If your server drifts, trigger the preparation playbook again from the Server dashboard to reinstall Docker or refresh Traefik certificates.
- **Add more sites**: Once the server is verified, you can deploy additional benches or sites without repeating the onboarding steps.

## Development & contributing

Nano Press uses [pre-commit](https://pre-commit.com/#installation) to keep Python, JS, and schema changes linted.

```bash
cd apps/nano_press
pre-commit install
```

Configured hooks include `ruff`, `eslint`, `prettier`, and `pyupgrade`. Run `pre-commit run --all-files` before opening a pull request.

### Continuous integration

GitHub Actions workflows (located under `.github/workflows/`) install the app on a test bench, run unit tests on pushes to `develop`, and execute security/static analysis via Frappe Semgrep rules and `pip-audit` on pull requests.

## Support

- Raise issues or feature requests via GitHub Discussions/Issues.
- Share deployment logs (redacted for secrets) when reporting problems.
- For enterprise onboarding or bespoke automation, reach out to the maintainers listed in the repository metadata.

## License

MIT