{"id":16889840,"url":"https://github.com/benoitc/rcouch_template","last_synced_at":"2025-04-11T13:08:32.191Z","repository":{"id":1995914,"uuid":"2928911","full_name":"benoitc/rcouch_template","owner":"benoitc","description":"Rebar templates for generating custom couchdb releases","archived":false,"fork":false,"pushed_at":"2012-02-23T12:00:48.000Z","size":143,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-09T10:07:22.563Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/benoitc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2011-12-06T23:26:48.000Z","updated_at":"2020-01-21T11:10:56.000Z","dependencies_parsed_at":"2022-08-26T09:20:29.921Z","dependency_job_id":null,"html_url":"https://github.com/benoitc/rcouch_template","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benoitc%2Frcouch_template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benoitc%2Frcouch_template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benoitc%2Frcouch_template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benoitc%2Frcouch_template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/benoitc","download_url":"https://codeload.github.com/benoitc/rcouch_template/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248404679,"owners_count":21097800,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-13T16:59:17.905Z","updated_at":"2025-04-11T13:08:32.150Z","avatar_url":"https://github.com/benoitc.png","language":"Shell","readme":"# Rebar templates for generating custom couchdb releases \n\nThis project provides rebar templates that allows you to create your own\nCouchDB releases or embed CouchDB applications based on the [rebared\nversion](https://github.com/refuge/rcouch) of Apache CouchDB provided by the [refuge\nproject](http://refuge.io). \n\nPlatforms supported are Linux, FreeBSD 8.0x and sup, MacOSX 10.6/10.7\nwith Erlang R13B04/R14x, Windows is coming. Tested on i386, amd64 and\nArm platforms.\n\n##Installation:\n\nInstall [rebar](https://github.com/basho/rebar). You can do that via\nhomebrew:\n\n    $ brew update\n    $ brew install rebar\n\nOr build it from source\n\n    $ git clone\n\n*Note:* make sure to use the latest rebar version.\n\nDrop these templates in ~/.rebar/templates.\n\n    \n##Create a custom CouchDB release\n\nTo create a custom release of CouchDB with your own plugins, use the\n**rcouch** template:\n\n    $ make myapp\n    $ cd myapp\n    $ rebar create template=rcouch appid=myapp\n\n\nThis prepares a custom rcouch release in the rel directory. You can\ncustomize it by adding your plugins to rebar config and editing\nrel/reltool.config. Then build and run it:\n\n    $ make rel\n    $ ./rel/myapp/bin/myapp\n\n##Embed CouchDB in your application\n\nTo start an Erlang OTP application that embeds CouchDB, use the\n**rebar_embed** template:\n\n    $ rebar create template=rcouch_embed appid=myapp\n\nIt creates a custom app in apps/myapp/src that you can edit. Then use it\nlike above.\n\n##Notes on building a truly distributable package\n\nThe package built above will still depend on some libraries from your\nsystem, so additional work has to be done to distribute it to\nolder/newer systems.\n\n1. CouchDB will depend on the ICU library version that was present in\n   your system at build time. To easily bundle this library with the\n   package, build with:\n\n         $ make rel USE_STATIC_ICU=1\n\n1. Check whether your package depends on Ncurses:\n\n         $ ldd ./rel/myapp/erts-*/bin/erlexec|grep ncurses\n\n    If it does, copy the .so file to ./rel/myapp/lib/ or rebuild Erlang\n    without this dependency.\n\n1. Decide whether you need SSL support in your package and check whether it\n   depends on OpenSSL:\n\n         $ ldd ./rel/myapp/lib/ssl-*/priv/bin/ssl_esock|grep 'libcrypto\\|libssl'\n\n    If it does, copy the .so file to ./rel/myapp/lib/ or rebuild Erlang\n    without this dependency.\n\nIf you copied any .so files in the last 2 steps, run this command, so\nthat your app can find the libraries:\n\n    $ sed -i '/^RUNNER_USER=/a\\\\nexport LD_LIBRARY_PATH=\"$RUNNER_BASE_DIR/lib\"' ./rel/myapp/bin/myapp\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenoitc%2Frcouch_template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbenoitc%2Frcouch_template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenoitc%2Frcouch_template/lists"}