A simple way to deploy a static site to dokku.
npm i -g dokku-pages
dokku-pages deploy -g dokku@mysite.com:myapp -p dist
By adding the --minimal
flag, you can dramatically decrease container footprint.
Deploy Command | Dokku Type | Image Size |
---|---|---|
deploy ... |
Herokuish Build Pack | 1.5 GB |
deploy ... --minimal |
Docker Build | 55 MB |
That's a saving of 96.4%
!
Usage: dokku-pages [options] [command]
Options:
-h, --help display help for command
Commands:
deploy [options] Deploys this library to your dokku
-g, --giturl <giturl> The dokku git url (eg: user@host:app)
-d, --dist <directory> The static directory
--minimal Use minimal docker image instead of herokuish buildpack
--allow-cors <domains> Allow CORS for a domain (example.com or *)
--dry-run Only build the image, won't deploy to dokku
-h, --help display help for command
help [command] display help for command
Cors configuration is only available with the flag --minimal
.
CORS Example Arguments:
--allow-cors '*' ANY domain
--allow-cors 'a1.com' a1.com OR www.a2.com
--allow-cors 'a1.com|a2.com' a1.com OR a2.com
--allow-cors '.+\.example.com' ANY subdomain of example.com
--allow-cors 'localhost:.+' ANY port on localhost
- This requires:
- npm
- git
- ssh
- You need to have ssh access to the dokku instance
- The app needs to exist on the dokku instance
This package is inspired by the ease of use of gh-pages