{"id":19910011,"url":"https://github.com/aitoroses/nixus","last_synced_at":"2026-02-17T01:02:40.678Z","repository":{"id":67181669,"uuid":"58144269","full_name":"aitoroses/NIXus","owner":"aitoroses","description":"NIXus a docker powerered next generation application server kind.","archived":false,"fork":false,"pushed_at":"2016-05-25T14:36:43.000Z","size":334,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-10-06T19:37:25.290Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aitoroses.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2016-05-05T16:16:32.000Z","updated_at":"2016-05-25T14:35:11.000Z","dependencies_parsed_at":"2023-06-10T05:15:41.685Z","dependency_job_id":null,"html_url":"https://github.com/aitoroses/NIXus","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/aitoroses/NIXus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aitoroses%2FNIXus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aitoroses%2FNIXus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aitoroses%2FNIXus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aitoroses%2FNIXus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aitoroses","download_url":"https://codeload.github.com/aitoroses/NIXus/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aitoroses%2FNIXus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29528247,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-17T00:57:22.232Z","status":"ssl_error","status_checked_at":"2026-02-17T00:54:25.811Z","response_time":115,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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-11-12T21:17:17.066Z","updated_at":"2026-02-17T01:02:40.184Z","avatar_url":"https://github.com/aitoroses.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NIXus\n\n**NIXus** a docker powerered next generation *application server* kind.\n\nApplication servers are typically coupled to ecosystems like .NET platform or JavaEE.\nThey are able to run just some kind of applications. In JavaEE, a server will run just JVM aplications deployed as WAR or EAR files.\n\n*Docker* is a relatively new technology. It's an *application container*.\nIt allows to run any contenerized application without having to install all the required runtime in the host machine.\n\n**NIXus** is basically a group of microservices containers that run in choreography.\n\n\u003e Basically it can run anything.\n\n# Usage\n\nInstall [Docker Toolbox](https://www.docker.com/products/docker-toolbox) and configure docker.\n\nRun the following command:\n```\ncurl -L https://raw.githubusercontent.com/aitoroses/NIXus/master/install.sh | bash\n```\n\nGet **NIXus** running:\n\n```\n$ nixus start\n```\n\nRun a hello world container two times (cluster), and specify a NIXUS_{PORT}:\n```\ndocker run -d -it -p :8000 -e NIXUS_8000=whoami-app jwilder/whoami\ndocker run -d -it -p :8000 -e NIXUS_8000=whoami-app jwilder/whoami\n```\n\nTry to do a CURL:\n```\n$ curl -L http://dev.docker/whoami-app\n$ curl -L http://dev.docker:8000\n```\n\nWill return the container ID of the one that responds.\n```\nI'm c1b218dd8881\n```\n\nIf you setup your DNS to resolve `whoami.dev.docker` you can also do\n```\ncurl -L http://whoami-app.dev.docker\n```\n\nThats all, your hello-world container is running with service discovery and clusterized.\n\n\n# How does it work?\n\n![](./docs/graffle.jpg)\n\nNIXus registers when a new container has started/stoped \nand then it creates the correspoinding configuration files and stores the required container information.\n\n# Service Autodiscovery\n\nThe **autodiscovery** container magically is able to map a route to a container automatically.\n\nFor example, just by doing `docker run -it -p :8000 -e NIXUS_8000=hello-app hello` the hello image will run as a container and it's context will be `hello-app`.\n\nThe port `tcp/8000` will be mapped to an arbitrary port in the host `tcp/8000 -\u003e tcp/31892`.\n\nNIXus will recognize that information and make the container discoverable through:\n\n* `http://domain.com:8000`\n* `http://domain.com/hello-app`\n* `http://hello-app.domain.com`\n\n\n---\n\n# Clusterization\n\nOther interesting property is that the proxy can replicate and load balance those containers across different hosts, \nso that each container is clusterizable on itself.\n\nLike in the example above, we can just do:\n\n* `docker run -d -it -p :8000 NIXUS_8000=hello-app hello`\n* `docker run -d -it -p :8000 NIXUS_8000=hello-app hello`\n* `docker run -d -it -p :8000 NIXUS_8000=hello-app hello`\n\nThe same container will be spawned 3 times and NIXus will handle load balancing by default.\n\n# License\n\nLicensed under the MIT license. 2016 aitor.oses@gmail.com","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faitoroses%2Fnixus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faitoroses%2Fnixus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faitoroses%2Fnixus/lists"}