百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
D

dokuen

> 编程语言
开源

适用于 mac 和 Linux 的个人 PaaS

549 stars0 点赞1 次浏览
访问官网GitHub

工具介绍

适用于 mac 和 Linux 的个人 PaaS

Dokuen, a Personal App Platform

Note: Dokuen is no longer supported.

Dokuen is a "personal app platform". It's the same idea as all of these PaaS and IaaS services out there, except you host it on your own machine. Currently, Dokuen supports Mac and Ubuntu. Here is an article that explains my motivations.

Requirements

  • Gitolite
  • Nginx

Installation

Step 1

gem install dokuen

Step 2

Install nginx using homebrew or your distro's package manager:

$ brew install nginx

Step 3

Create a git user and install gitolite according to package directions. You'll be making changes to the config later, but for now you should be able to create a new repository and push to it.

Step 4

Run this:

$ sudo mkdir -p /usr/local/var/dokuen
$ cd /usr/local/var/dokuen
$ sudo dokuen setup .

This will ask you a few questions, set up a few directories, and install a few useful commands. It'll also show you some things you need to do. Crucially, you'll need to modify your gitolite config and install it.

Creating an App

$ ssh git@ dokuen create --application=
git@:.git

$ git remote add dokuen git@:.git

Add some environment variables

$ ssh git@ dokuen config_set -V BUILDPACK_URL="https://github.com/heroku/heroku-buildpack-ruby.git" DOKUEN_SCALE="web=1" --application=

Deploy

$ git push dokuen master

Check it out!

$ open http://:12345/

Available "app" Sub-commands

  • create
  • config_set = ...
  • config_delete ...
  • scale =...
  • buildpacks
  • install_buildpack
  • remove_buildpack
  • run_command
  • shutdown
  • restart

DNS Setup

I have my home router set up to forward ports 80 and 443 to my mac mini, and I have a dynamic DNS system set up with a wildcard CNAME Unfortunately this setup is hard to automate so Dokuen doesn't manage any of it for you.

What it does do is set up Nginx server configs for you that you can choose to use. If you want to use them, put this at the bottom of the http section of nginx.conf:

include /usr/local/var/dokuen/nginx/*.conf;

Then, force a restart of your app:

$ ssh git@ dokuen scale web=0 --application=
$ ssh git@ dokuen scale web=1 --application=

How it works

When you run ssh git@ dokuen create --application=foo, Dokuen creates a few directories in it's install directory, setting things up for app deployments. In particular, it creates this structure:

foo/
    releases/    # timestamped code pushes
    env/         # environment variables. FILENAME => file contents
    logs/        # log files, one per process
    build/       # cache directory for build side-effects like gems

When you run git push dokuen master, the following series of events happens:

  • If the target git repo does not exist, gitolite creates it
  • git runs the pre-receive hook, which invokes /path/to/dokuen/install/bin/dokuen, which is a wrapper around dokuen with the correct config file set
  • runs git archive >
  • invokes mason on the tmpdir, building the application into a timestamped subdirectory of releases
  • creates a symlink current that points at the new timestamped directory
  • creates a symlink previous that points at the previous value of current
  • spins up the configured number of processes as set using dokuen scale
  • writes out a new nginx configuration and restarts nginx
  • shuts down the previous processes

When Dokuen "spins up" a process, it forks the main process, creates a Dokuen::Wrapper instance and calls run! on it. The wrapper's job is to immediately daemonize and run the command line in the Procfile for the given named process, capture logging info, restarting the process if it dies, and forwarding signals to it as appropriate. It writes it's own pid as well as the port it was given at fork-time into a pidfile at current/.dokuen/dokuen....pid.

Rails

Unfortunately the stock Heroku buildpacks install a vendored node.js compiled for the Heroku platform, which happens to be linux. This doesn't work for Mac, which means you have to use a slightly patched version. This one works with a homebrew-installed node.js: https://github.com/peterkeen/heroku-buildpack-ruby

License

MIT

Contact and Development

Fork and send me a pull request. If you'd like to talk about Dokuen there's #dokuen on irc.freenode.net, as well as a mailing list.

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Ruby

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言