oneclick-proof

Simple Node.js app demonstrating how to package for one-click deploys on self-hosted panels.

Each request increments a count that's stored on the local filesystem, which should persist between restarts; set the destination directory path via a DATA_DIRECTORY environment variable.

These panels maintain their own 'app catalogs' for one-click installs; until your app is included there, it will require more clicks to setup. Below are instructions for each platform so that you can test easily before submission.

Many of them also require publishing a Docker image somewhere to install. For simplicity the examples below uses pre-built images.

Cloudron

Setup

0. Install Cloudron via one-click images on one of various hosting platforms.

1. Clone the project locally:

git clone https://github.com/0dataapp/oneclick-proof

2. From the project directory, run the install command via the Cloudron CLI:

cd oneclick-proof
cloudron install --image 0data/oneclick-proof:cloudron --location oneclick-proof

Updates

1. From the project directory, run the update command via the Cloudron CLI:

cloudron update --image 0data/oneclick-proof:cloudron --app oneclick-proof

See the packaging tutorial or Cloudron official packages for reference. You can also use Cloudron itself to build and as a registry.

Caprover

Setup

0. Install Caprover via one-click DigitalOcean droplet.

with docker-compose

1. Navigate to Apps → Create A New App → One-Click Apps/Databases , then search for >> TEMPLATE << or scroll to the bottom.
2. Select the >> TEMPLATE << app and paste the configuration from caprover/compose.yml.
3. Name your app oneclick-proof or something else, then click Deploy.

without docker-compose

1. Navigate to Apps → Create A New App.
2. Check the box for Has Persistent Data, name your app as oneclick-proof or something else, and then click Create New App.
3. Navigate to your app settings, then App Configs → Persistent Directories.
4. Set Path in App to /usr/src/app/__local and "Label" to oneclick-proof-local; click Save & Restart.
5. See the update command below to finalize.

---

Other deployment methods, include uploading a .tar file and deploying code directly from your machine without publishing a Docker image via the Caprover CLI:

git clone https://github.com/0dataapp/oneclick-proof
cd oneclick-proof
caprover deploy

Updates

via Docker image

1. Navigate to Deployment, enter 0data/oneclick-proof:latest into Deploy via ImageName, then click Deploy. It may take some time after 'finishing' so give it a minute.

via local directory

1. Call deploy again but with a flag to use the previous configuration:

caprover deploy -d

More info on packaging and deployment:

• Captain Definition File
• Persistent Apps
• How to Run Docker Compose on CapRover
• Caprover official packages

Coolify

Setup

0. Install Coolify via one-click images on Hetzner, DigitalOcean or other hosting platforms.

1. Navigate to Projects → choose/create a project… → Resources → + New → Applications → Git Based → Public Repository.

2. Configure the following parameters:

   • Repository URL

      https://github.com/0dataapp/oneclick-proof/tree/master
     

   • Build Pack

      Docker Compose
     

   • Docker Compose Location

      /coolify/compose.yml
     

3. Select Continue and then, on the following Configuration page, click Deploy.

4. Setup a domain under Configuration → General → Domains by entering something like https://oneclick-proof.[your root domain] and clicking Save, or make a random one by clicking Generate Domain; in case of SSL issues click Redeploy.

Updates

1. Click Redeploy or Advanced → Force deploy (without cache) to pull from the Git repository.

More information:

• Adding a new service template to Coolify
• Coolify examples
• Coolify official packages

Questions

Feel free to reach out on Mastodon or Bluesky.