{"id":16296930,"url":"https://github.com/ahwayakchih/nobbic","last_synced_at":"2025-09-13T21:12:09.698Z","repository":{"id":66587507,"uuid":"321777925","full_name":"ahwayakchih/nobbic","owner":"ahwayakchih","description":"🦾🍱 Nobbic helps you quickly setup a pod with NodeBB, database, NGINX, etc... containers.","archived":false,"fork":false,"pushed_at":"2021-10-03T15:06:58.000Z","size":577,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-05T21:34:45.016Z","etag":null,"topics":["containers","nodebb","podman"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ahwayakchih.png","metadata":{"files":{"readme":"README.markdown","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"ko_fi":"ahwayakchih","liberapay":"ahwayakchih"}},"created_at":"2020-12-15T20:11:14.000Z","updated_at":"2023-12-27T09:16:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"16593e34-b7bc-41c8-b45d-32948c4a7478","html_url":"https://github.com/ahwayakchih/nobbic","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ahwayakchih/nobbic","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahwayakchih%2Fnobbic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahwayakchih%2Fnobbic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahwayakchih%2Fnobbic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahwayakchih%2Fnobbic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ahwayakchih","download_url":"https://codeload.github.com/ahwayakchih/nobbic/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahwayakchih%2Fnobbic/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265866282,"owners_count":23840938,"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":["containers","nodebb","podman"],"created_at":"2024-10-10T20:24:28.546Z","updated_at":"2025-07-19T01:04:43.832Z","avatar_url":"https://github.com/ahwayakchih.png","language":"Shell","funding_links":["https://ko-fi.com/ahwayakchih","https://liberapay.com/ahwayakchih"],"categories":[],"sub_categories":[],"readme":"Nobbic\n======\n\nNobbic helps you nicely fit [NodeBB](https://nodebb.org/), database and other stuff into a single pod with containers controlled by [`podman`](https://podman.io/).\n\nWhile it's quite easy to start the NodeBB docker container alone, things complicate quickly when one wants to start also database container, [NGINX](https://www.nginx.com/) proxy container, etc... all the while trying out different versions of software. It's not difficult, but it takes time (and a lot of reading) if it's not something you do everyday already.\n\nBest of all is that after NodeBB is installed and running, it can be controlled with usual `podman` commands.\nNobbic does not usurp ownership of anything. It just helps to [set things up and running](./docs/actions/start.markdown), and then may help with [backing them up](./docs/actions/backup.markdown), [upgrading](./docs/actions/upgrade.markdown) and [restoring](./docs/actions/restore.markdown), but only if you want to - it's all optional.\n\n\n## Requirements\n\nAll it requires to start is the [`bash`](https://www.gnu.org/software/bash/) shell and the `podman` installed and running on a [Linux](https://www.linux.org/) operating system.\n\n**Podman** should be at least **v2.2.1** and **[configured for running rootless](https://github.com/containers/podman/blob/master/docs/tutorials/rootless_tutorial.md)**.\n\nIf you're not running Linux at the moment, or just do not want to change anything in how it's set up, simplest way to test whole thing is to [install Alpine Linux (with podman)](./docs/SetupPodmanOnAlpineHost.markdown) in a virtual machine (like [QEMU](https://www.qemu.org/)).\n\n\nDepending on which database and additional software you will use, prepare between 360 MB (with Redis), 500 MB (with PostgreSQL) and 800 MB (with MongoDB) hard drive space at minimum.\nYou will also need 2 GB or more of RAM available.\n\n\n## Compatibility\n\nIt was tested with various versions of **NodeBB** between (and including) **v1.12.1** and **v1.18.3**.\nDepending on NodeBB version, it was tested with [Node.js](https://nodejs.org/) versions from 8 to 15, and various versions and combinations of databases supported by NodeBB ([MongoDB](https://www.mongodb.com/), [PostgreSQL](https://www.postgresql.org/) and [Redis](https://redis.io/)).\n\nFor a full list of software, read [docs/Compatibility.markdown](./docs/Compatibility.markdown).\n\n\n## Installation\n\nYou can download ZIP archive with this project from [GitHub](https://github.com/ahwayakchih/nobbic/archive/main.zip)\nand unzip it to selected directory, or clone repository if you already have [`git`](https://git-scm.com/) installed:\n\n```sh\ngit clone https://github.com/ahwayakchih/nobbic.git\n```\n\nOnce you have directory with files in it, open command line and change to that directory, for example:\n\n```sh\ncd nobbic\n```\n\nOnce in its directory, you can use it from command line, for example:\n\n```sh\n./nobbic help\n```\n\nYou can add nobbic's full path to the `PATH` environment variable, or keep prefixing commands with path to its location, e.g., `./nobbic` or `~/nobbic/nobic`, etc...\nFor clarity, example commands following in this and other [documents found in \"docs\"](./docs) subdirectory will not be prefixed, as if nobbic was added to the `PATH`.\n\n\n## Usage\n\nTo quickly proceed to creating and starting NodeBB, try:\n\n```sh\nAPP_ADD_REDIS=1 nobbic start my-new-forum\n```\n\nThat will start latest released NodeBB version, with latest version of Redis database, and make it accessible through \"http://localhost:8080\" URL.\n\nIt will take some time to download and prepare all the stuff for the first time (somewhere between 15-30 minutes, but it all depends on network, available processor(s) and RAM).\nEvery next try that uses the same Node.js version, should build much faster. Simply starting the same pod, once it was created, will be nearly as fast as if NodeBB was started directly, without any containers.\n\nRead [docs/Usage.markdown](./docs/Usage.markdown) to see full list of supported actions.\n\n\n## TODO\n\nThis is not a finished project yet (it may never be, since it depends on other projects that are being worked on also).\n\nRead [TODO.markdown](./TODO.markdown) to see a list of changes that are already planned.\n\n\n## Why \"Nobbic\"?\n\nBecause it's a **No**de**BB** **I**n a **C**ontainer ;).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahwayakchih%2Fnobbic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fahwayakchih%2Fnobbic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahwayakchih%2Fnobbic/lists"}